# How do you keep one brand across many AI agents and teammates?

Updated 2026-11-21 · https://briefatto.com/guides/one-brand-across-many-agents-and-teammates/

Keep the brand in one versioned DESIGN.md in the repository, point each agent at it, and let the record say what is current. Briefatto Board stamps each version, keeps the approval and the notes in `board log`, writes the pointer to AGENTS.md and CLAUDE.md, and `board status` lists every piece made under an old version.

## One source, in the repository

DESIGN.md sits at the project root and is committed with the code. The Briefatto Board block in AGENTS.md and CLAUDE.md tells each agent, whoever runs it, to read DESIGN.md before any visual work. Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any other agent that reads AGENTS.md and runs shell commands get the same instruction.

## One way to change it

The block also says brand changes go through `board freeze`. Each freeze stamps the next version and can carry a note, for example `--note "Signal weight from orange to green"`. `board log` shows the history and `board diff v1 v2` shows what changed.

## One answer to what is current

- Each piece declares the guide version it was made under.
- `board status` lists which pieces are current, which are stale and which are unrecorded, whoever made them.
- On a frozen board, `board check` notes every colour and font that is not in the current guide.

## Questions and answers

### Does every teammate need to install Briefatto Board?

It is saved as a dev dependency, so teammates get it with the project's dependencies, and the block in AGENTS.md and CLAUDE.md travels with the repository.

### Who can change the brand?

Anyone who runs `board freeze`, and every freeze is recorded in `board log` with its note.

### 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 do you keep design context across different AI coding tools?](https://briefatto.com/guides/one-design-guide-across-ai-coding-tools/)
- [How do you record the brand decisions an AI agent works from?](https://briefatto.com/guides/record-brand-decisions-for-ai-agents/)
- [How to find which assets are stale after a rebrand](https://briefatto.com/guides/find-stale-assets-after-a-rebrand/)
- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.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/skill/briefatto-board/board.mjs
- 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
