Briefatto LabBriefatto Lab

Comparisons

Style Dictionary vs DESIGN.md: what does each give a coding agent?

Style Dictionary exports your design tokens to platforms such as CSS, JS, iOS and Android; DESIGN.md tells a coding agent how the brand uses those values. Briefatto Board is the layer that makes agents use them: one versioned DESIGN.md recorded from your rendered pages, a pointer in AGENTS.md and CLAUDE.md, board check on the output and board status after a change.

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

Different jobs

Style DictionaryDESIGN.md with Briefatto Board
JobExport design tokens to every platform you build forTell the agent how the brand looks and how to use those values
Starts fromYour token source filesYour rendered pages, or a direction you chose
ProducesPlatform files such as CSS and JSA frozen guide with exact rendered styles, versions and a stale list
Read byYour buildThe agent, before any visual work

Use them together

  1. Keep Style Dictionary building your tokens into CSS.
  2. Run npx briefatto-board adopt . on the pages that use them. The agent reads the computed styles and the CSS variables the pages use, and writes DESIGN.md by role.
  3. Run npx briefatto-board freeze .. Freeze records the exact styles your tokens produce on the page and checks the values written in the guide against them.
  4. From then on the block in AGENTS.md and CLAUDE.md sends every session to DESIGN.md, and board check notes any colour or font a piece paints outside it.

When a token changes

Rebuild with Style Dictionary, update DESIGN.md and freeze the next version with a note. board status lists which pieces still declare the old version.

Questions and answers

Do I have to choose between Style Dictionary and DESIGN.md?

No. Style Dictionary builds the values; DESIGN.md, kept by Briefatto Board, is what the agent reads before it uses them.

How does the agent learn my token names?

It inspects the CSS variables your pages use when it writes DESIGN.md, and freeze reads a braced reference such as {colors.primary} as a token name.

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. styledictionary.com/ checked 2026-11-21
  2. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  3. github.com/Briefatto/briefatto-board/blob/main/README.md
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
  5. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  6. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  7. github.com/Briefatto/briefatto-board/blob/main/LICENSE