Briefatto LabBriefatto Lab

Questions

How to create a DESIGN.md from your site or a new brand

For an existing site, run npx briefatto-board adopt ., let your agent write DESIGN.md from the captures and freeze it with npx briefatto-board freeze .. For a new brand, put the brief in brief.md and go from references to directions to a pick to a freeze.

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

From the site you already have

shell
npx briefatto-board adopt .
npx briefatto-board freeze .

adopt captures your pages and their computed styles, desktop and mobile. It finds top-level HTML pages or a conventional build with an index page; for a running site, pass --page <url> for each representative route.

Your agent writes DESIGN.md from the captures. freeze records exact styles from a fresh render, validates the prose against them and stamps the guide as v1.

From a brief

Put the brief in brief.md and ask your agent to follow the skill. It shows you a reference sheet, draws three directions from your picks, revises the one you choose and writes the design guidance after your yes.

shell
npx briefatto-board refs .
npx briefatto-board directions .
npx briefatto-board freeze . lead

Use your chosen direction's ID in place of lead. Briefatto Board needs Node.js 24 or later; the first render prints the Playwright command to install Chromium if it is missing.

Questions and answers

Does the tool write the prose for me?

Your agent writes it, from the captures or the chosen direction. Freeze records the exact values and validates the prose against them.

What does freeze do?

It records source wording and exact styles from a fresh render, validates the authored guidance, stamps and archives the guide, and tells future sessions to read it first.

Can I adopt a site that only runs on a dev server?

Yes. Pass --page <url> to board adopt for each representative route.

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