# How to make AI agents follow your brand guidelines across sessions

Updated 2026-11-21 · https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/

Keep the brand in one versioned DESIGN.md and point every session to it. Briefatto Board freezes the guide as a numbered version, writes the pointer into AGENTS.md and CLAUDE.md, and lists stale pieces with `board status`.

## The parts

1. **One guide.** `board adopt .` and `board freeze .` create DESIGN.md as v1 from your existing site, or you start a brand from a brief.
2. **A pointer.** `npx briefatto-board install` writes the block into AGENTS.md and CLAUDE.md; after a freeze it tells every session to read DESIGN.md first.
3. **A record.** Each piece declares the guide version it was made under, and `board status` lists which pieces are current, stale or unrecorded.

## In practice

In the Plumb example, the signal colour changed in v2: the README header was redrawn and current, and `board status` marked the link card and the post stale.

## Questions and answers

### Does this work across different agents?

Yes. Briefatto Board works with any coding agent that reads AGENTS.md and runs shell commands.

### How does a new session know the brand?

The block in AGENTS.md and CLAUDE.md tells it to read the frozen DESIGN.md before any visual work.

### 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/)
- [Your AI coding agent ignores your design system: what to do](https://briefatto.com/guides/ai-coding-tools-ignore-your-design-system/)
- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)
- [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/)

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