# How do you record the brand decisions an AI agent works from?

Updated 2026-11-21 · https://briefatto.com/guides/record-brand-decisions-for-ai-agents/

Write each decision into the record the agent reads: with Briefatto Board, the client's exact approval goes in a fenced `approval` block in `refs/notes.md` before v1, every later freeze carries a `--note`, and `board log` shows the history. Confirmed musts and must-nots go in fenced `constraint` blocks, and freeze writes them into DESIGN.md.

## Before v1

Record the client's words verbatim in `refs/notes.md`. Put the exact production approval in a fenced block named after the chosen direction:

```md
```approval lead
<the client's exact words of approval>
```
```

Working alone as your own client? Freeze with `npx briefatto-board freeze . lead --self-approved`. Either way, `board log` records the decision.

## Musts and must-nots

Put each confirmed brand must or must-not in its own fenced `constraint` block. At freeze, Board writes Brand facts, Campaign copy, Client musts and must-nots and the exact computed styles into the generated block of DESIGN.md, so every later session reads them as part of the guide.

## Every change after

```sh
npx briefatto-board freeze . lead --note "Signal weight from orange to green"
npx briefatto-board log
npx briefatto-board diff v1 v2
```

`board log` shows the version history with its notes, and `board diff` shows what changed between versions.

## Questions and answers

### I am my own client. Do I still need an approval block?

No. Freeze with `--self-approved`, and the decision is recorded in `board log`.

### Where does the agent see the client's musts?

In DESIGN.md. Freeze writes them into its generated block, the guide the block tells every session to read first.

### 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 one brand across many AI agents and teammates?](https://briefatto.com/guides/one-brand-across-many-agents-and-teammates/)
- [How do you run a rebrand with an AI coding agent?](https://briefatto.com/guides/rebrand-with-an-ai-agent-step-by-step/)
- [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 start a brand with an AI agent when there is none yet?](https://briefatto.com/guides/start-a-brand-with-an-ai-agent/)

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