Where the drift comes from
Each session rebuilds the brand from whatever it can see. With no single current guide, small differences in colour, type and spacing add up from page to page.
How Board pins it
- One current guide.
board freezestamps DESIGN.md as v1, v2 and on, and the block in AGENTS.md and CLAUDE.md tells every session to read it first. - Exact values. Freeze records source wording and exact styles from a fresh render, so the guide matches the rendered pages when it is frozen.
- A version on every piece. Each final layout carries a
board-versionmeta tag, andboard statuslists which pieces are current, stale or unrecorded. - A history.
board logshows the versions andboard diff v1 v2shows what changed.
Catch drift on a single piece
On a frozen board, board check notes every painted colour and font that is not in the current guide, and names the earlier version a value came from.
Questions and answers
Is a DESIGN.md file enough on its own?
It is the centre. Briefatto Board makes it hold with the version stamp, the pointer every session reads and a check on the rendered output.
What happens when the brand changes?
Freeze the next version with a note, and board status lists the pieces still made under the old one. See change a colour in DESIGN.md.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.