# How to make an AI agent follow your design rules

Updated 2026-11-21 · https://briefatto.com/guides/make-an-agent-follow-your-design-rules/

Give the agent one frozen design guide, then check what it makes. `board check` renders each piece and fails it when text is clipped, off the canvas, over other text, too small, in a font that never loaded, or below WCAG contrast.

## A check that does not depend on the agent remembering

`board check` is a program run on the rendered page, not a prompt to a model. It writes a receipt that records which checks ran and sets exit status 1 when any piece fails.

On the Plumb example, it failed a 16px label where 22px was the minimum where it is seen, and passed it once the label was raised to 26px.

Delivery PNG and PDF files are decoded and compared with their editable HTML source, and the receipt records the SHA-256 of the checked bytes.

## Make the check part of the instruction

After `board freeze`, the block in AGENTS.md and CLAUDE.md tells the agent to read `DESIGN.md` before visual work and to run `board check` on every piece before handing it over.

## Questions and answers

### What exactly does the check test?

Legibility, fonts, contrast and anti-patterns: clipped, off-canvas, overlapping or too-small text, fonts that never loaded, contrast below WCAG, and the tells the Impeccable detector finds.

### Does it work with any agent?

Yes. It runs on the rendered HTML piece, whichever agent made it.

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

- [Design checks as scripts instead of prompts: how board check works](https://briefatto.com/guides/deterministic-design-checks-vs-prompts/)
- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)
- [Cursor ignores your rules: how to keep it on brand](https://briefatto.com/guides/cursor-ignores-rules/)
- [Why your AI-made UI looks off, and how to check it](https://briefatto.com/guides/why-your-ai-ui-looks-off/)

## Sources

- 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/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
