# Design docs drift from the real design: how freeze stops it

Updated 2026-11-21 · https://briefatto.com/guides/design-docs-drift-from-the-real-design/

A design doc drifts when nobody compares it with the pages it describes. `board freeze` records exact styles from a fresh render and validates the written guide against them, naming any conflicting style values.

## What freeze checks

`board freeze` records source wording and exact styles from a fresh render in a generated DESIGN.md block, validates the authored guidance against those values and names conflicting style values.

Each freeze stamps a new numbered version and archives it. `board diff v1 v2` shows what changed between versions.

## When the site changes

Run `board adopt .` and `board freeze .` again: the guide is recorded from the new render and stamped as the next version.

## Questions and answers

### Should the design live in code instead of a document?

Both. Briefatto Board records exact styles from your rendered pages into the document, so the document is checked against what your code renders.

### How do I see what changed between versions?

`board log` shows the history and `board diff v1 v2` shows the change.

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

- [Your AI coding agent ignores your design system: what to do](https://briefatto.com/guides/ai-coding-tools-ignore-your-design-system/)
- [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 to find which assets are stale after a rebrand](https://briefatto.com/guides/find-stale-assets-after-a-rebrand/)
- [DESIGN.md vs a design system: what is the difference?](https://briefatto.com/guides/design-md-vs-design-system/)

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