Briefatto LabBriefatto Lab

Questions

How do you start a brand with an AI agent when there is none yet?

Put the brief in brief.md and follow references, directions, pick, freeze: the agent shows you a reference sheet, draws three directions from your picks, revises the one you choose and writes DESIGN.md after your yes. Briefatto Board renders each sheet, records your approval and freezes the guide as v1.

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 flow

  1. Brief. Run npx briefatto-board install, write brief.md, and ask your agent to follow the Briefatto Board skill.
  2. References. The agent finds live references and captures them with npx briefatto-board refs . --capture <url> first.png. You see refs/sheet.png and say which parts to work from; it waits for you.
  3. Directions. It draws three distinct directions with your real copy and a designed wordmark in each. npx briefatto-board directions . renders them as sheets.
  4. Pick. You choose one or ask for changes. It revises and shows the sheet again.
  5. Freeze. Your approval goes in refs/notes.md, or you freeze as your own client with --self-approved. npx briefatto-board freeze . lead stamps DESIGN.md as v1.

Then make the kit

Declare the places your audience will see the work in formats.json, or use the defaults: hero 1440x900, post 1080x1080 and story 1080x1920. The agent makes each piece from DESIGN.md, and board kit . checks the layouts and final exports.

Questions and answers

What if I already have a site?

Adopt it instead: npx briefatto-board adopt . captures your pages, the agent writes DESIGN.md, and npx briefatto-board freeze . freezes it.

What if none of the directions fits?

Ask for changes. The agent revises a direction or shows replacements, and nothing is frozen until you say yes.

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