Different jobs
| Style Dictionary | DESIGN.md with Briefatto Board | |
|---|---|---|
| Job | Export design tokens to every platform you build for | Tell the agent how the brand looks and how to use those values |
| Starts from | Your token source files | Your rendered pages, or a direction you chose |
| Produces | Platform files such as CSS and JS | A frozen guide with exact rendered styles, versions and a stale list |
| Read by | Your build | The agent, before any visual work |
Use them together
- Keep Style Dictionary building your tokens into CSS.
- 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. - 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. - From then on the block in AGENTS.md and CLAUDE.md sends every session to DESIGN.md, and
board checknotes 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.