Which agent reads which file
| Agent | What its documentation says |
|---|---|
| Claude Code | Persistent instructions through CLAUDE.md or AGENTS.md files. |
| Codex | Custom instructions with AGENTS.md. |
| Cursor | AGENTS.md as a plain-markdown alternative to .cursor/rules. |
| GitHub Copilot | AGENTS.md files anywhere in the repository; the nearest one takes precedence. |
| OpenCode | AGENTS.md, and CLAUDE.md in any directory without one. |
| Lovable | AGENTS.md or CLAUDE.md at the top level, read with every message. |
One block, both files, one guide
The Briefatto Board block sits between <!-- briefatto-board:start --> and <!-- briefatto-board:end --> in each file. After a freeze it tells the agent to read DESIGN.md before any visual work, to route brand changes through board freeze and to run board check on every piece.
Running the installer again replaces that one block instead of adding a second, so the files never disagree.
Questions and answers
Will it overwrite my CLAUDE.md?
No. It adds one marked block and leaves the rest of the file as it is.
Why not put the whole design system in AGENTS.md?
The instruction files load in every session. A short pointer keeps them small, and the guide in DESIGN.md is frozen, versioned and checked against a render.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.