mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-08-07 18:06:53 +01:00
659a6326a1
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>
58 lines
2 KiB
Markdown
58 lines
2 KiB
Markdown
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.
|