# Is a design check still worth running when the agent has a DESIGN.md?

Updated 2026-11-21 · https://briefatto.com/guides/still-need-a-design-check-with-design-md/

Yes: DESIGN.md steers what the agent draws, and only a check of the rendered page shows what it actually drew. On the Plumb example, a link card redrawn from the frozen v2 guide still failed `board check`: its label was too small to read where the card is seen.

## What the guide moves

A lot. In our [drift test](https://briefatto.com/guides/does-design-md-keep-your-brand-drift-test/), agents with no design file matched the brand's fonts in 0 of 18 pieces, and their palettes wandered from session to session. With a DESIGN.md they matched the fonts in 53 of 54 pieces and brand colour coverage reached 99%.

That is the brand arriving. It says nothing about whether a headline fits its box at the size the post is seen.

## What only the check catches

- **Plumb.** The signal colour changed in v2 and the link card was redrawn from the new guide. `board check` failed it: a 16px label where 22px was the minimum where it is seen. Raised to 26px, it passed.
- **Afterlight Matinees.** During the direction round, the check caught an off-canvas offer, start time, door time and call to action, and a date line running past the mobile canvas. The agent fixed all of it before the client approved.

Both pieces were made with the brand in hand, and both failed the floor until they were fixed.

## Wire both in

After `board freeze`, the block in AGENTS.md and CLAUDE.md tells the agent to read DESIGN.md before any visual work and to run `board check` on every piece before handing it over. The check sets exit status 1 when a piece fails, so the same command can gate a commit:

```sh
npx briefatto-board check .
```

Git aborts the commit when a pre-commit hook exits non-zero. [Set up the hook](https://briefatto.com/guides/design-check-in-pre-commit-hook/).

## Questions and answers

### Isn't a review step just another prompt?

No. `board check` is a program run on the rendered page, so it costs no model tokens and gives the same answer every time it runs.

### Does the check judge taste?

Taste stays with the model, which makes every aesthetic call. The check fails what can be measured: clipped, off-canvas, overlapping or too-small text, fonts that never loaded and contrast below WCAG, plus the Impeccable detector's pattern rules.

### What does the check write down?

A receipt, check.json: every check that ran, every one that was skipped and why. A pass with a skipped contrast check says so.

## 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/)
- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [How do you enforce design checks in a pre-commit hook?](https://briefatto.com/guides/design-check-in-pre-commit-hook/)
- [How do you know if text on a social card is too small?](https://briefatto.com/guides/text-too-small-on-a-social-card/)
- [Does a DESIGN.md keep your brand? We measured the drift](https://briefatto.com/guides/does-design-md-keep-your-brand-drift-test/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://git-scm.com/docs/githooks (checked 2026-11-21)
