Briefatto LabBriefatto Lab

Questions

Can I use DESIGN.md without Google Stitch?

Yes. Briefatto Board makes a DESIGN.md from your existing site or from a brief, with no Stitch account, and keeps it versioned for Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and other coding agents.

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 a site or from a brief

  • You have a site. npx briefatto-board adopt . captures its pages and computed styles, your agent writes DESIGN.md from what it sees, and npx briefatto-board freeze . freezes it as v1.
  • You have a brief. Put it in brief.md. The agent shows a reference sheet, draws three directions from your picks, revises the one you choose and writes the guide after your yes.

Where Google's format fits

Google Labs publishes design.md as a format specification for describing a visual identity to coding agents: tokens in YAML front matter, prose on how to apply them.

Briefatto Board reads that kind of front matter. When you freeze, it compares the colour, font-family and font-size values written in your DESIGN.md, including a YAML colors: block, with values recorded from a fresh render, and names any value that conflicts.

What runs where

Everything runs in your project from npx. The Briefatto Board command line calls no model API and needs no API key: the coding agent you already use writes the guide, and Board captures, renders, records and checks.

Questions and answers

Do I need a Google account to use DESIGN.md?

No. Briefatto Board runs from npx in your project and needs no account and no API key.

Can I keep the DESIGN.md I already have?

Yes. Freeze validates the authored guide in your root DESIGN.md against a fresh render and names any style value that conflicts, then stamps it as a version.

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/src/board/design-validation.ts
  4. github.com/google-labs-code/design.md checked 2026-11-21
  5. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  6. github.com/Briefatto/briefatto-board/blob/main/src/board/design-references.ts
  7. github.com/Briefatto/briefatto-board/blob/main/LICENSE