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

Updated 2026-11-21 · https://briefatto.com/guides/keep-design-tokens-consistent-in-cursor/

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.

## 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`.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [How do you put a design system into Cursor rules?](https://briefatto.com/guides/cursor-rules-design-system/)
- [Cursor ignores your rules: how to keep it on brand](https://briefatto.com/guides/cursor-ignores-rules/)
- [Design tokens for AI coding agents: what goes in DESIGN.md?](https://briefatto.com/guides/design-tokens-for-ai-coding-agents/)
- [Your AI coding agent ignores your design system: what to do](https://briefatto.com/guides/ai-coding-tools-ignore-your-design-system/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://cursor.com/docs/context/rules (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
