Briefatto LabBriefatto Lab

Comparisons

DESIGN.md vs a design system: what is the difference?

A design system is the components and tokens your product is built from, and DESIGN.md is the written guide your agent reads before it designs. Briefatto Board keeps that guide true: it records exact styles from a fresh render, validates the prose against them and versions the result.

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

Code and guide

Design systemDESIGN.md
Lives inCode: components, tokens, themesOne document at the project root
Read byYour buildYour agent, before visual work
SaysWhat to build withHow 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 check tests 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.

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/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  2. github.com/Briefatto/briefatto-board/blob/main/README.md
  3. github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
  4. github.com/Briefatto/briefatto-board/blob/main/LICENSE