# What does DESIGN.md solve when AI-generated UI keeps drifting?

Updated 2026-11-21 · https://briefatto.com/guides/ai-ui-keeps-drifting/

DESIGN.md gives every session one current answer to what the brand looks like. Briefatto Board makes that answer exact and versioned: freeze records styles from a fresh render, each piece declares the version it was made under, and `board status` lists what is stale.

## Where the drift comes from

Each session rebuilds the brand from whatever it can see. With no single current guide, small differences in colour, type and spacing add up from page to page.

## How Board pins it

- **One current guide.** `board freeze` stamps DESIGN.md as v1, v2 and on, and the block in AGENTS.md and CLAUDE.md tells every session to read it first.
- **Exact values.** Freeze records source wording and exact styles from a fresh render, so the guide matches the rendered pages when it is frozen.
- **A version on every piece.** Each final layout carries a `board-version` meta tag, and `board status` lists which pieces are current, stale or unrecorded.
- **A history.** `board log` shows the versions and `board diff v1 v2` shows what changed.

## Catch drift on a single piece

On a frozen board, `board check` notes every painted colour and font that is not in the current guide, and names the earlier version a value came from.

## Questions and answers

### Is a DESIGN.md file enough on its own?

It is the centre. Briefatto Board makes it hold with the version stamp, the pointer every session reads and a check on the rendered output.

### What happens when the brand changes?

Freeze the next version with a note, and `board status` lists the pieces still made under the old one. See [change a colour in DESIGN.md](https://briefatto.com/guides/what-happens-when-you-change-a-design-md-token/).

### 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 docs drift from the real design: how freeze stops it](https://briefatto.com/guides/design-docs-drift-from-the-real-design/)
- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)
- [What happens when you change a colour or font in DESIGN.md?](https://briefatto.com/guides/what-happens-when-you-change-a-design-md-token/)
- [How do you keep design context across different AI coding tools?](https://briefatto.com/guides/one-design-guide-across-ai-coding-tools/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
- 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/src/board/check.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
