# Cursor + Briefatto Board: on-brand UI from one DESIGN.md

Updated 2026-11-21 · https://briefatto.com/guides/cursor-briefatto-board/

Run `npx briefatto-board install` and freeze a DESIGN.md: Cursor reads AGENTS.md as agent instructions and loads skills from `.claude/skills/`, and Briefatto Board puts its pointer and its skill in exactly those places. From then on Cursor's agent is told to read your design guide before any visual work, and `board check` tests what it draws.

## How Briefatto Board works with Cursor

- Cursor's [rules documentation](https://cursor.com/docs/context/rules) lists AGENTS.md as agent instructions in markdown format, a plain-markdown alternative to `.cursor/rules`. Briefatto Board writes its block there.
- Cursor's [skills documentation](https://cursor.com/docs/skills) loads project skills from `.agents/skills/` and `.cursor/skills/`, and for compatibility from `.claude/skills/` and `.codex/skills/`. The Briefatto Board skill installs into `.claude/skills/`.

## Set it up in Cursor

1. In your project folder, run `npx briefatto-board install` (Node.js 24 or later). It adds the skill under `.claude/skills/` and writes the Briefatto Board block into AGENTS.md and CLAUDE.md.
2. Create your guide. For an existing site, run `npx briefatto-board adopt .`, let your agent write DESIGN.md from the captures and run `npx briefatto-board freeze .` to stamp v1. For a new brand, follow [how to create a DESIGN.md](https://briefatto.com/guides/how-to-create-a-design-md/).
3. Ask for any visual piece, then run `npx briefatto-board check .` on it. It fails clipped text, text off the canvas, text over other text, small text, fonts that never loaded and low contrast.

## What Cursor gets from Briefatto Board

- **One brand, versioned.** DESIGN.md is frozen as v1, v2 and on, and every session is pointed to the current one.
- **A check on the rendered piece.** `board check` tests what was drawn, not what was promised.
- **A stale list after a rebrand.** `board status` lists which pieces are current, stale or unrecorded.

## Questions and answers

### How do I make Cursor follow my brand?

Freeze your brand as a DESIGN.md with Briefatto Board. The block it writes into AGENTS.md tells Cursor's agent to read DESIGN.md before any visual work.

### Do I need a .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

- [OpenAI Codex + Briefatto Board: one DESIGN.md for your agent](https://briefatto.com/guides/codex-briefatto-board/)
- [OpenCode + Briefatto Board: DESIGN.md for your agent](https://briefatto.com/guides/opencode-briefatto-board/)
- [GitHub Copilot + Briefatto Board: make the agent read DESIGN.md](https://briefatto.com/guides/github-copilot-briefatto-board/)
- [Cursor ignores your rules: how to keep it on brand](https://briefatto.com/guides/cursor-ignores-rules/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- 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/LICENSE
- https://cursor.com/docs/context/rules (checked 2026-11-21)
- https://cursor.com/docs/skills (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with Cursor.
