Merge pull request #16 from Curabis/rule/claude-md-must-reference-all-agents

Foreslaa regel: claude-md-must-reference-all-agents

custom/knowledge/architecture/claude-md-must-reference-all-agents.md

@@ -0,0 +1,58 @@
+bc-version: [all]
+domain: architecture
+keywords: [claude-md, agents, visibility, setup, mode-b, curabis-standard]
+technologies: [al]
+countries: [w1]
+application-area: [all]
+---
+
+## Description
+
+When new agents are added to BCQuality and installed via Mode B update, they
+are written to `.github/.agents/` but CLAUDE.md is never touched (Mode B
+preserves project-specific files). This means newly installed agents are
+invisible to Claude — it will not invoke them because it does not know they exist.
+
+This gap was observed when four court agents (court, lincoln, aurelius, munger)
+were installed via Mode B but remained uncallable until the developer asked
+directly. Claude had no way to discover them proactively.
+
+## Rule
+
+After any installation or update of agent files in `.github/.agents/`, Claude
+must verify that every `.agent.md` file in that directory is referenced in
+`CLAUDE.md`. Any agent not listed in CLAUDE.md must be flagged to the developer
+with a proposed addition before the session continues.
+
+## What NOT to do
+
+- Do not silently install agents without checking CLAUDE.md coverage
+- Do not assume that because a file exists in `.github/.agents/` it is known to Claude
+- Do not wait until session end to flag the discrepancy — flag it immediately after install
+- Do not add agents to CLAUDE.md without showing the developer the proposed wording first
+
+## Signal to watch for
+
+After running Mode B (or any agent install), compare:
+
+```
+Get-ChildItem .github/.agents/*.agent.md | Select-Object -ExpandProperty BaseName
+```
+
+against the agent references in CLAUDE.md. Any filename present in the directory
+but absent from CLAUDE.md is a gap that must be surfaced.
+
+## Message to developer
+
+When a gap is found, output exactly this before continuing:
+
+```
+⚠️ Ny agent installeret men ikke refereret i CLAUDE.md:
+
+  - <agent-navn>.agent.md
+
+Claude kan ikke kalde denne agent medmindre den tilføjes til CLAUDE.md.
+Vil du have mig til at tilføje den nu?
+```
+
+Do not continue with other activity until the developer has responded.