# What happens when you change a colour or font in DESIGN.md?

Updated 2026-11-21 · https://briefatto.com/guides/what-happens-when-you-change-a-design-md-token/

When you change DESIGN.md and freeze again, Briefatto Board stamps the next guide version, and `board status` lists every piece made under an older one. Nothing is redrawn behind your back.

## The sequence

1. Update DESIGN.md with the change and the client's words.
2. Run `npx briefatto-board freeze . lead --note "your change"`, with your direction's ID in place of `lead`. Freeze records exact styles from a fresh render, validates the guide, and stamps and archives the next version.
3. Run `npx briefatto-board diff v1 v2` to see the change and `npx briefatto-board status` to see which pieces are stale.

In the Plumb example, the README header was redrawn and current under v2, and the link card and post were marked stale.

## Questions and answers

### Will the agent update my old pieces?

When you ask. `board status` tells you which pieces to revisit, and a piece is current again once it is revised and declares the new version.

### Can I see the history of brand changes?

Yes. `board log` shows the version history and the decisions recorded with it, and `board diff v1 v2` shows what changed.

### 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 find which assets are stale after a rebrand](https://briefatto.com/guides/find-stale-assets-after-a-rebrand/)
- [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/)
- [How to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)

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