core-architecture

core-architecture is a cursor rule for Cursor from benwilcock/rhdh-lab. It costs 1,156 tokens per session, scanned A, original, Apache-2.0.

A set of rules for RHDH Local, a local development and testing setup for Red Hat Developer Hub. It explains project structure, configuration changes, container commands, networking, and documentation.

In plain words
What is it for?
Use it when running RHDH Local, editing custom settings, working with its containers, checking TechDocs, or maintaining the project’s documentation and repository structure.
Why use it?
It prevents changes from being made in the wrong place or containers being restarted in a way that breaks connected services. It also makes clear that the setup is for development and testing, not production.

Cursor rule for Cursor

Written for Cursor: installed under .cursor/.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/benwilcock/rhdh-lab/core-architecture
Clone the repo
git clone --depth 1 https://github.com/benwilcock/rhdh-lab

Made for: Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for core-architecture

README.md
[![agentmods](https://agentmods.dev/badge/rules/benwilcock/rhdh-lab/core-architecture.svg)](https://agentmods.dev/rules/benwilcock/rhdh-lab/core-architecture)
Your own site
<a href="https://agentmods.dev/rules/benwilcock/rhdh-lab/core-architecture"><img src="https://agentmods.dev/badge/rules/benwilcock/rhdh-lab/core-architecture.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,156 This file is loaded in full into every session.
When invoked 1,156 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01156 $0.01156
Opus 5 $0.00578 $0.00578
Sonnet 5 $0.00231 $0.00231
Haiku 4.5 $0.00116 $0.00116

Measured 5d ago against content hash 44fd7ea23be4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

core-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/rules/core-architecture.mdc · 78 lines

How it starts

The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.

RHDH Local Project - Core Architecture & Critical Rules

Project Context

This workspace wraps RHDH Local -- a development and testing environment for Red Hat Developer Hub (RHDH). It enables platform engineers to run RHDH locally using Podman or Docker containers, testing software catalogs, TechDocs, plugins, templates, and configurations without a Kubernetes cluster.

RHDH Local is for development and testing only, NOT production use.

Critical Rules (MUST follow without exception)

  1. Always Use the CLI: Use ./lab up and ./lab down for container lifecycle -- NEVER use podman compose restart/up/down directly when orchestrator or lightspeed are enabled
  2. Network Namespace Sharing: Lightspeed containers share RHDH's network namespace via network_mode: "service:rhdh" -- restarting one requires restarting all
  3. Edit in rhdh-customizations/: All configuration edits go in rhdh-customizations/; ./lab up automatically syncs copies into rhdh-local/
  4. Pristine Project: Never modify files in rhdh-local/ directly -- it must always match the upstream git repository
  5. Always Document: Every significant change must be documented. Update relevant docs in docs/, READMEs, and inline comments so humans can understand what was done and why

Why These Rules Exist

  • Breaking Rule 1 or 2: Causes 504 Gateway Timeout errors (network namespace desynchronization)
  • Breaking Rule 3: Changes don't take effect, or git conflicts occur
  • Breaking Rule 4: Makes the project un-updatable via git pull
  • Breaking Rule 5: Creates hidden knowledge lost between sessions and invisible to human collaborators

Copy-Sync Customization System (Overview)

The fundamental architectural pattern of this workspace:

  • rhdh-local/ -- Official RHDH Local git repository (PRISTINE, never modified)
  • rhdh-customizations/ -- All your configuration files, overrides, and settings
  • apply-customizations.sh -- Copies files from rhdh-customizations/ into rhdh-local/ so containers can read them (containers only see mounted dirs, so symlinks to external paths would break)
  • remove-customizations.sh -- Deletes the copies from rhdh-local/ to restore pristine state

Read the full file on GitHub · 78 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 78 lines · 1,156 tokens per session scan A 44fd7ea23be4

Subscribe to this mod's changes

core-architecture is a cursor rule published in the GitHub repository benwilcock/rhdh-lab (2 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 1,156 tokens to every session, about $0.0058 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.