Briefatto LabBriefatto Lab

Questions

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

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.

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

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.

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/skill/briefatto-board/SKILL.md
  3. github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  5. github.com/Briefatto/briefatto-board/blob/main/LICENSE