What to write
- Values by role. Name what each colour and face does, such as the signal colour, the body face or the heading face, not only its token name.
- How the parts are built. Describe each recurring part by its job and how it uses the values.
- When to use which. The rules a designer would hand over: what carries the brand, what recomposes on other canvases.
- Font load lines under
## Typography, so every piece loads the real face. - Tokens in YAML front matter, as Google's design.md format does. Freeze reads them.
What Board writes for you
You do not copy your token file in. At freeze, Board records source wording and exact styles from a fresh render in a generated block and validates the values you wrote against them, naming any conflict. Measured ratios, coverage percentages and centroid coordinates stay out of the prose.
How agents use them
- The block in AGENTS.md and CLAUDE.md tells every session to read DESIGN.md before any visual work.
board checknotes any colour or font a piece paints outside the current guide;--consistencyadds the nearest frozen colour.board statuslists which pieces are current after a token change.
Questions and answers
YAML front matter or prose?
Either, or both. Freeze reads colour, font-family and font-size values in the front matter and in the prose, and checks them against the render.
Should DESIGN.md hold every token?
Hold the values the brand depends on, by role. The exact rendered styles go into the generated block at freeze.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.