What each part does
| Google's design.md format | Briefatto Board | |
|---|---|---|
| Holds | Tokens in YAML front matter, such as colors, typography, rounded and spacing, and prose on how to apply them | That file, plus a generated block of source wording and exact styles from a fresh render |
| Versions | Your Git history | v1, v2 and on, with board log and board diff v1 v2 |
| Reaches the agent | Your own instruction file | A marked block in AGENTS.md and CLAUDE.md |
- After drawing,
board checktests every rendered piece for clipped, overlapping and too-small text, unloaded fonts and contrast below WCAG. - After a change,
board statuslists which pieces are current, stale or unrecorded.
How Board reads the front matter
- Board reads colours in a YAML
colors:block, andfontFamilyandfontSizefields, as claims about the design. - At freeze, Board compares each claim with the values recorded from a fresh render and names any conflict.
- Board reads a reference in braces, such as
{colors.primary}, as a token name, not as a new value.
Start
npx briefatto-board install
npx briefatto-board adopt .
npx briefatto-board freeze .Between adopt and freeze, your agent writes DESIGN.md from the captures. Keep your tokens in the front matter; freeze checks them.
Questions and answers
Is Google's design.md an official standard?
Google Labs publishes it as a format specification on GitHub, google-labs-code/design.md. See is DESIGN.md an official standard.
Do I need Google Stitch for it?
No. Briefatto Board makes and keeps a DESIGN.md from your site or a brief. See DESIGN.md without Google Stitch.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.