Briefatto LabBriefatto Lab

Questions

How to make an AI 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.

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

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.

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. github.com/Briefatto/briefatto-board/blob/main/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  5. github.com/Briefatto/briefatto-board/blob/main/LICENSE