# How do you run a rebrand with an AI coding agent?

Updated 2026-11-21 · https://briefatto.com/guides/rebrand-with-an-ai-agent-step-by-step/

Record the client's words, update DESIGN.md and freeze the next version with a note; then let `board status` list the stale pieces and have the agent redraw each one against the new guide. `board check` tests every redraw, and each piece's version tag moves to the new version when it is done.

## The steps

1. Record the client's words and update DESIGN.md.
2. Freeze the next version: `npx briefatto-board freeze . lead --note "Signal weight from orange to green"`. Freeze records the new exact styles and names any value in the prose that conflicts with them.
3. Run `npx briefatto-board diff v1 v2` to see what changed and `npx briefatto-board status` for the stale pieces.
4. Ask the agent to redraw each stale piece from the new DESIGN.md and set its `board-version` meta tag to v2.
5. Run `npx briefatto-board check .` on each redraw. Any colour or font left from v1 comes back as a note naming its old role.

## What it looked like on Plumb

Plumb's signal colour changed from orange to green in v2. The README header was redrawn and current, and `board status` marked the link card and post stale. A redraw failed `board check` because a label was 16px where 22px was the minimum where it is seen; raised to 26px, it passed.

## Questions and answers

### Will the agent redraw everything at once?

It redraws what you ask for, and `board status` shows what is left.

### How do I show the client what changed?

`board diff v1 v2` shows the changes between the guide versions, and `board log` holds the notes.

### 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/)
- [How do you find the old brand colours left after a rebrand?](https://briefatto.com/guides/find-old-brand-colours-after-a-rebrand/)
- [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 record the brand decisions an AI agent works from?](https://briefatto.com/guides/record-brand-decisions-for-ai-agents/)

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