What a usable DESIGN.md holds
- Parts by their job. Name each recurring part by what it does, then say how it is built and how the parts sit together.
- Layout, spacing, navigation, components and logo, described by role, the way a designer briefs the next designer.
- The real voice. Example copy comes from your actual pages, not from a template.
- How it recomposes. Say how the arrangement changes for other canvases.
- Typography with load lines. Under
## Typography, say which parts use each face and include the font load lines. - Sufficient on its own. Write for a reader who has this file and your brand assets, and nothing else.
What Board writes for you
You do not type the exact values. board freeze records source wording and exact styles from a fresh render in a generated block, validates the prose against those values and names any conflicting style value. The prose carries the judgement; the generated block carries the numbers.
The steps
- Run
npx briefatto-board install, thennpx briefatto-board adopt .. - The agent opens each screenshot, reads
evidence.jsonfor computed styles and visible copy, and inspects your CSS variables, Tailwind configuration, theme and logo files. - It drafts DESIGN.md. Preview the result with
npx briefatto-board freeze . --dry-run. - Freeze it:
npx briefatto-board freeze .. From then on, AGENTS.md and CLAUDE.md tell every session to read it first.
Questions and answers
Should I put hex codes in the prose?
Yes. Freeze reads colour, font-family and font-size values written in the guide and compares them with the render, so a wrong value is named before the guide is frozen.
Will Claude Code read the file?
Yes. After freeze, the block in CLAUDE.md and AGENTS.md tells it to read DESIGN.md before any visual work.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.