Briefatto LabBriefatto Lab

Comparisons

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

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.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.md

What each part does

Google's design.md formatBriefatto Board
HoldsTokens in YAML front matter, such as colors, typography, rounded and spacing, and prose on how to apply themThat file, plus a generated block of source wording and exact styles from a fresh render
VersionsYour Git historyv1, v2 and on, with board log and board diff v1 v2
Reaches the agentYour own instruction fileA 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

shell
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.

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. github.com/google-labs-code/design.md checked 2026-11-21
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
  3. github.com/Briefatto/briefatto-board/blob/main/README.md
  4. github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
  5. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  6. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  7. github.com/Briefatto/briefatto-board/blob/main/LICENSE