# Design checks as scripts instead of prompts: how board check works

Updated 2026-11-21 · https://briefatto.com/guides/deterministic-design-checks-vs-prompts/

`board check` is a program run on the rendered page, not a prompt to a model, so checks a script can do cost no model tokens. It writes a receipt and sets exit status 1 when any piece fails.

## What it tests

- Text that is clipped, off the canvas or over other text.
- Text too small where it is seen: the floor scales its 11 px displayed-text minimum to the canvas width.
- A font that never loaded, and contrast below WCAG.
- Anti-patterns found by the Impeccable detector.
- Delivery PNG and PDF files, decoded and compared with their editable HTML source.

## What it writes

A receipt that records which checks ran and, for exports, the SHA-256 of the checked bytes. A model can read the receipt; it never has to judge the page.

## Questions and answers

### Does board check call a model?

No. It renders the page and tests it.

### Can I use it in CI?

Yes. It sets exit status 1 when any piece fails, so a pipeline stops on 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

- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [Why your AI-made UI looks off, and how to check it](https://briefatto.com/guides/why-your-ai-ui-looks-off/)
- [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/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/pbakaus/impeccable
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
