Briefatto LabBriefatto Lab

Questions

How do you keep design tokens consistent in Cursor's output?

Freeze your tokens as the exact styles your site renders, point Cursor at them, and check the result: Briefatto Board records them in DESIGN.md and writes the pointer to AGENTS.md. board check --consistency lists any colour off the frozen palette with its nearest frozen colour.

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

Record the real values

Run npx briefatto-board adopt .. Cursor's agent reads the computed styles and inspects your CSS variables, Tailwind configuration and theme files, then writes DESIGN.md. npx briefatto-board freeze . records the exact styles from a fresh render in a generated block and checks the colour, font-family and font-size values in the prose against them.

Point Cursor at them

Cursor's documentation lists AGENTS.md as agent instructions. The Briefatto Board block there tells the agent to read DESIGN.md before any visual work.

Catch the strays

  • On a frozen board, board check notes every painted colour and every font that is not in the current guide.
  • Add --consistency for a kit format, and it lists each off-palette colour with its nearest frozen colour, and fonts outside the guide.
  • A colour from an earlier version is named with that version and the role it had there.

Questions and answers

Does it lint my CSS for raw hex values?

It checks the rendered piece, what users actually see: every painted colour and font outside the current guide gets a note, however it reached the page.

Can I keep tokens in YAML front matter?

Yes. Freeze reads a YAML colors: block and fontFamily and fontSize fields, and reads a 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. github.com/Briefatto/briefatto-board/blob/main/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. cursor.com/docs/context/rules checked 2026-11-21
  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