Briefatto LabBriefatto Lab

Questions

How do you put a design system into Cursor rules?

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.

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

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.

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. cursor.com/docs/context/rules checked 2026-11-21
  2. cursor.com/docs/skills checked 2026-11-21
  3. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  4. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  5. github.com/Briefatto/briefatto-board/blob/main/README.md
  6. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  7. github.com/Briefatto/briefatto-board/blob/main/LICENSE