Code and guide
| Design system | DESIGN.md | |
|---|---|---|
| Lives in | Code: components, tokens, themes | One document at the project root |
| Read by | Your build | Your agent, before visual work |
| Says | What to build with | How the brand looks and speaks: layout, components, type and voice by role |
In Briefatto Board, DESIGN.md holds authored prose plus a generated block of source wording and exact styles recorded from a fresh render.
How Briefatto Board keeps the guide true
board adopt .captures your pages and computed styles, so the guide starts from what your site renders.board freeze .validates the written guide against the recorded values and names any conflicting style values.board checktests every rendered piece against the quality floor.
Questions and answers
Does DESIGN.md replace my design system?
No. It sits next to it as the guide your agent reads. Your components and tokens stay where they are.
Can Briefatto Board create DESIGN.md from my existing site?
Yes. npx briefatto-board adopt . captures the site's pages and computed styles, your agent writes DESIGN.md from what it sees, and npx briefatto-board freeze . freezes it as v1.
Is it free?
Yes. Briefatto Board is open source under Apache-2.0.