# Cursor ignores your rules: how to keep it on brand

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

Put the brand where Cursor reads it and check what it draws. Briefatto Board writes a pointer to your frozen DESIGN.md into AGENTS.md, which Cursor's documentation lists as agent instructions, and `board check` tests every rendered piece.

## The fix

1. Run `npx briefatto-board install` so AGENTS.md carries the Briefatto Board block. Cursor's [rules documentation](https://cursor.com/docs/context/rules) lists AGENTS.md as agent instructions in markdown format.
2. Freeze your DESIGN.md, so the block tells the agent to read it before visual work.
3. Run `npx briefatto-board check .` on what the agent made. It fails clipped text, text off the canvas, text over other text, text too small where it is seen, fonts that never loaded and contrast below WCAG.

## The skill is where Cursor looks

Cursor's [skills documentation](https://cursor.com/docs/skills) loads skills from `.claude/skills/` for compatibility, and that is where `board install` puts the Briefatto Board skill. The full setup is on the [Cursor page](https://briefatto.com/guides/cursor-briefatto-board/).

## Questions and answers

### Is the check specific to Cursor?

No. `board check` runs on rendered HTML pieces, whichever agent made them.

### Do I need .cursor/rules for this?

No. Cursor's documentation offers AGENTS.md as a plain-markdown alternative to `.cursor/rules`.

### 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 to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)
- [Design checks as scripts instead of prompts: how board check works](https://briefatto.com/guides/deterministic-design-checks-vs-prompts/)
- [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/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
