bcquality/custom/knowledge/architecture/claude-md-must-reference-all-agents.md at 7fedcece6d516838ff5b3672e87b0356935b195f

mirror of https://github.com/microsoft/BCQuality.git synced 2026-08-06 17:36:53 +01:00

Michael Dieringer 659a6326a1 Foreslaa regel: claude-md-must-reference-all-agents

Observation fra session 2026-06-25: agenter installeret via Mode B forbliver
usynlige for Claude fordi CLAUDE.md ikke opdateres automatisk.

Foreslaaet af Francis. Valideret af Immanuel (alle 4 tests bestaaet).
Afventer Michaels godkendelse via merge.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-25 17:50:42 +02:00

2 KiB

Raw Blame History

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.

2 KiB Raw Blame History