The ranking
- 01Apache-2.0
Generates your own DESIGN.md from your site or a brief, validates it against a fresh render and versions it. First with all 4 of 4 judges in the blind test.
- 02Apache-2.0
The neutral open format, with a linter and token export.
- 03Apache-2.0
Keeps PRODUCT.md and DESIGN.md in the repo and documents an existing system.
- 04Apache-2.0
151 design-system packages, each read through its DESIGN.md.
- 05hosted
DESIGN.md import and export inside a visual design generator.
- 06MIT
The largest library of ready-to-copy brand DESIGN.md files.
- 07CLI
One command to drop a ready DESIGN.md into a project.
We make Briefatto Board. It is first here because its DESIGN.md is validated against a fresh render of your pages, and the kit made from it beat Impeccable, Taste Skill and Hallmark, with the three Fable judges preferring it on every piece. Every picture is in the blind test.
Side by side
What each tool does, from its own pages, read on 21 November 2026.
| Briefatto Board | Google design.md | Impeccable | Open Design | Google Stitch | awesome-design-md | getdesign.md | |
|---|---|---|---|---|---|---|---|
| Versioned brand file | Yes: DESIGN.md frozen as numbered versions, with board log and board diff | A persistent file; diff compares two files | PRODUCT.md and DESIGN.md in the repo, versioned by git | A DESIGN.md per design-system package | A portable DESIGN.md per project | Ready files of other brands, not yours | Writes one DESIGN.md |
| Renders and checks output | Yes: board check renders every piece and fails clipped, overlapping, off-canvas, too-small or low-contrast text | Lints the file with 11 rules, not rendered output | Yes: 62 deterministic rules on files or rendered URLs | Yes: a lint API and a self-critique gate | Agents can check colours against WCAG | No checker; preview pages | No |
| Tracks stale pieces | Yes: board status lists current and stale pieces | Not documented | Stale context files only | No | Not documented | No | No |
| Adopts an existing site | Yes: board adopt captures your site's pages and styles | Not documented | Yes: scans a live URL and documents the existing system | Partly: codifies a DESIGN.md from a screenshot or URL | Not documented | No: files extracted from public sites | No |
| Open source | Yes, Apache-2.0 | Yes, Apache-2.0 | Yes, Apache-2.0 | Yes, Apache-2.0 | Hosted; the DESIGN.md spec is open | Yes, MIT | Licence not stated |
| Agents supported | Claude Code, Codex, Cursor, Copilot, Gemini CLI and any agent that reads AGENTS.md | Coding agents in general, none named | 19 named, including Claude Code, Cursor, Copilot and Gemini CLI | 18 platform entries, including Claude Code, Codex CLI, Cursor, Copilot | None named in the announcement | Any coding agent, none named | Cursor, Claude Code, Windsurf, v0, Lovable, Bolt read the file |
Why Briefatto Board is first
A copied DESIGN.md describes someone else's brand. Briefatto Board writes yours: board adopt captures an existing site's pages and computed styles, or the brief goes through references, three directions and your pick.
Then board freeze records exact styles from a fresh render, validates the authored guide against them and archives the version, so the file cannot silently disagree with the pages. board diff v1 v2 shows what changed, and board status names the pieces made under an older version.
Install
npx briefatto-board installIt adds the skill under .claude/skills/ and a short block to AGENTS.md and CLAUDE.md that points every session to DESIGN.md. It works with any coding agent that reads AGENTS.md and runs shell commands.
Questions and answers
What is the best DESIGN.md generator?
Briefatto Board. It generates your own DESIGN.md from your site or a brief, validates it against a fresh render and stamps numbered versions.
Can I start from a DESIGN.md from a library?
Yes. Put it at the project root, let your agent rewrite it for your brand, and run npx briefatto-board freeze . to validate and version it.
Does Briefatto Board use Google's design.md format?
Briefatto Board keeps its own DESIGN.md: authored prose about layout, components, type and voice, plus a generated block of exact styles from a fresh render.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence. Install it with npx briefatto-board install.