Briefatto LabBriefatto Lab

Questions

How is DESIGN.md different from a Tailwind config?

A Tailwind config defines the tokens your utilities use; DESIGN.md tells an agent how the brand uses them, by role, with the exact styles your pages render. Briefatto Board's skill reads your Tailwind configuration when it writes DESIGN.md, and board freeze checks the guide against a fresh 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 holds

Tailwind config or @themeDESIGN.md with Briefatto Board
HoldsTheme variables that decide which utility classes existLayout, components, type and voice by role, plus exact styles recorded from a render
Read byTailwind, when it compiles your CSSThe agent, before any visual work
AnswersWhich values are availableHow the brand uses them, and what a new piece should look like
VersionedWith your codeFrozen as v1, v2 and on, with a stale list after a change

How they stay in step

Tailwind's documentation says theme variables defined with @theme become regular CSS variables when your CSS is compiled. After board adopt, the agent inspects those CSS variables and your Tailwind configuration, and board freeze records the computed styles your pages actually render. Freeze then names any style value in the prose that conflicts with them.

Questions and answers

Should DESIGN.md replace tailwind.config?

No. Keep your theme where Tailwind reads it. DESIGN.md is the brief the agent reads before it uses that theme.

Does it work with Tailwind's @theme variables?

Yes. The agent reads the CSS variables they compile to, and freeze records the styles they produce on your pages.

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. tailwindcss.com/docs/theme 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/CHANGELOG.md
  5. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  6. github.com/Briefatto/briefatto-board/blob/main/LICENSE