One source, in the repository
DESIGN.md sits at the project root and is committed with the code. The Briefatto Board block in AGENTS.md and CLAUDE.md tells each agent, whoever runs it, to read DESIGN.md before any visual work. Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any other agent that reads AGENTS.md and runs shell commands get the same instruction.
One way to change it
The block also says brand changes go through board freeze. Each freeze stamps the next version and can carry a note, for example --note "Signal weight from orange to green". board log shows the history and board diff v1 v2 shows what changed.
One answer to what is current
- Each piece declares the guide version it was made under.
board statuslists which pieces are current, which are stale and which are unrecorded, whoever made them.- On a frozen board,
board checknotes every colour and font that is not in the current guide.
Questions and answers
Does every teammate need to install Briefatto Board?
It is saved as a dev dependency, so teammates get it with the project's dependencies, and the block in AGENTS.md and CLAUDE.md travels with the repository.
Who can change the brand?
Anyone who runs board freeze, and every freeze is recorded in board log with its note.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.