Where each agent looks
- Claude Code reads CLAUDE.md, and by default reads AGENTS.md only when no CLAUDE.md,
.claude/CLAUDE.mdorCLAUDE.local.mdsits in the working directory or above it. That rule is why the installer writes the same block into both files. - Cursor reads AGENTS.md in the project root and in subdirectories.
- GitHub Copilot works from the nearest AGENTS.md in the directory tree. If your app sits in a subfolder with its own AGENTS.md, copy the marked block into that file too.
- Gemini CLI loads GEMINI.md by default. Add AGENTS.md to
context.fileNamein settings.json.
{
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}Confirm it loaded
| Agent | What to run or read |
|---|---|
| Claude Code | /context all lists the files under Memory files; /memory shows whether an AGENTS.md was read |
| Copilot in VS Code | The References section of the response names the instructions file |
| Gemini CLI | /memory show prints the full memory sent to the model; /memory reload re-scans the files |
Look for the block between <!-- briefatto-board:start --> and <!-- briefatto-board:end -->. After a freeze it tells the agent to read DESIGN.md before any visual work.
Confirm it was followed
Loaded is not the same as obeyed. VS Code's documentation says the References section checks inclusion, not compliance, and Claude Code's says CLAUDE.md is context, not enforced configuration. So check the work:
- Each piece made under the guide carries a
board-versionmeta tag.board statuslists every piece as current, stale or unrecorded, and an unrecorded piece is your sign the skill was skipped. board check --consistencylists each colour off the frozen palette and each font outside the guide.
Questions and answers
Can I make Claude Code read the guide without fail?
Not by instruction alone: Claude Code's documentation calls CLAUDE.md context and puts anything that must run at a fixed point in a hook. Run npx briefatto-board check . in a Claude Code hook, a pre-commit hook or CI. A piece that breaks the floor stops there; colours and fonts outside the guide are listed in the receipt for you to read.
Does running the installer again add a second block?
No. Running it again replaces its one marked block in AGENTS.md and CLAUDE.md.