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 checknotes every painted colour and every font that is not in the current guide. - Add
--consistencyfor 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.