Briefatto LabBriefatto Lab

Questions

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

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.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.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

shell
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.

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. github.com/Briefatto/briefatto-board/blob/main/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/LICENSE