# Google's design.md format with Briefatto Board: versions and checks

Updated 2026-11-21 · https://briefatto.com/guides/google-design-md-format-briefatto-board/

Google Labs' design.md format describes a visual identity to coding agents as YAML tokens plus prose; Briefatto Board adds what keeps it true over time: values recorded from a fresh render, numbered versions, a pointer in AGENTS.md and CLAUDE.md, `board check` on the output and `board status` after a change. When you freeze, Board reads the YAML `colors:` and typography fields and checks them against the render.

## 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 check` tests every rendered piece for clipped, overlapping and too-small text, unloaded fonts and contrast below WCAG.
- **After a change,** `board status` lists which pieces are current, stale or unrecorded.

## How Board reads the front matter

- Board reads colours in a YAML `colors:` block, and `fontFamily` and `fontSize` fields, 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

```sh
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](https://briefatto.com/guides/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](https://briefatto.com/guides/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`.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [A free, open-source DESIGN.md tool for coding agents](https://briefatto.com/guides/design-md-open-source/)
- [The best DESIGN.md generators and libraries in 2026](https://briefatto.com/guides/best-design-md-generators-2026/)
- [Style Dictionary vs DESIGN.md: what does each give a coding agent?](https://briefatto.com/guides/style-dictionary-vs-design-md/)
- [DESIGN.md vs a design system: what is the difference?](https://briefatto.com/guides/design-md-vs-design-system/)
- [Can I use DESIGN.md without Google Stitch?](https://briefatto.com/guides/design-md-without-google-stitch/)

## Sources

- https://github.com/google-labs-code/design.md (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
