# How do you put a design system into Cursor rules?

Updated 2026-11-21 · https://briefatto.com/guides/cursor-rules-design-system/

Keep the rule to a pointer and the design system in DESIGN.md: Cursor's documentation lists AGENTS.md as a plain-markdown alternative to `.cursor/rules`, and Briefatto Board writes its pointer there. The guide is frozen from your real site, and `board check` tests what Cursor draws.

## The setup

1. Run `npx briefatto-board install`. It writes the block to AGENTS.md and CLAUDE.md and puts the skill in `.claude/skills/`, where Cursor also loads skills.
2. Run `npx briefatto-board adopt .`, ask Cursor's agent to write DESIGN.md from the captures, then `npx briefatto-board freeze .`.
3. Ask for UI as usual. Run `npx briefatto-board check .` on each piece.

## Why a pointer, not a pasted design system

A design system pasted into a rule is a copy that nobody checks. DESIGN.md is frozen from a fresh render, so its styles are the ones your site actually shows, and it carries a version. When the brand changes, `board status` lists which pieces still declare the old version.

## Keep Cursor on your palette

Add `--consistency` to `board check` for a kit format, and it lists colours off the frozen palette, each with its nearest frozen colour, and fonts outside the guide.

## Questions and answers

### Do I still need a .cursorrules or .cursor/rules file?

No. The block lives in AGENTS.md, which Cursor's documentation lists as a plain-markdown alternative to `.cursor/rules`.

### Will Cursor find the Briefatto Board skill?

Yes. Cursor's documentation says it loads skills from `.claude/skills/`, where `board install` puts the skill.

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

- [Cursor ignores your rules: how to keep it on brand](https://briefatto.com/guides/cursor-ignores-rules/)
- [How do you keep design tokens consistent in Cursor's output?](https://briefatto.com/guides/keep-design-tokens-consistent-in-cursor/)
- [Your AI coding agent ignores your design system: what to do](https://briefatto.com/guides/ai-coding-tools-ignore-your-design-system/)
- [AGENTS.md vs CLAUDE.md: which file should hold your design rules?](https://briefatto.com/guides/agents-md-vs-claude-md/)
- [Cursor + Briefatto Board: on-brand UI from one DESIGN.md](https://briefatto.com/guides/cursor-briefatto-board/)

## Sources

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