Briefatto LabBriefatto Lab

Questions

Where can I see a real DESIGN.md example?

Briefatto Board's repository has three worked examples: plumb, a brief for an invented open-source tool; bakery, a brief with CC0 photographs; and current-site, a small site to adopt. Plumb goes from brief to frozen guide to a brand change, with every piece checked.

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 examples

ExampleStarts fromShows
plumbA brief for an invented open-source toolReferences, directions, freeze, a kit and a brand change
bakeryA brief with CC0 photographsA brand built around supplied images
current-siteA small existing siteboard adopt, then a guide written from the captures

What Plumb shows

Plumb went from its brief to a frozen design guide, and its README header, link card and square post all passed board check. When a redrawn label was 16px where 22px was the minimum where it is seen, board check failed it; raised to 26px, it passed.

After the signal colour changed in v2, the README header was redrawn and current, and board status marked the link card and post stale.

Try one

  1. Clone the repository and open an example folder.
  2. Run npx briefatto-board install there and ask your agent to follow the skill.
  3. For current-site, start with npx briefatto-board adopt .; for plumb or bakery, start from brief.md.

Questions and answers

Can I copy an example as my template?

Learn the flow from them, then make your own: board adopt writes DESIGN.md from your site, or the flow runs from your own brief, so the guide describes your brand.

Which example fits an existing site?

current-site, a small site to adopt with board adopt . and board freeze ..

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