The split
- CLAUDE.md: your project's general instructions, plus the Briefatto Board block, which tells Claude Code to read
DESIGN.mdbefore visual work. - DESIGN.md: the design guide, with authored prose and a generated block of exact styles, stamped with a version by
board freeze.
With the guide out of CLAUDE.md, a brand change is one frozen, versioned file change, and board diff v1 v2 shows it.
Questions and answers
Should I paste my colours and fonts into CLAUDE.md?
No. board freeze records exact styles from a render into DESIGN.md, so nobody copies them by hand.
Does the pointer go into AGENTS.md as well?
Yes. The installer writes the same block to AGENTS.md and CLAUDE.md.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.