Briefatto LabBriefatto Lab

Questions

How do you extract a design system from an existing website?

Capture the site as it renders: npx briefatto-board adopt . records screenshots, computed styles and visible copy for each page you choose, your agent writes DESIGN.md from that evidence, and board freeze stamps it with the exact values.

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

Choose what to capture

A design system shows up across routes and screen sizes, so capture the pages that carry it, not just the home page.

Your site isRun
Static HTML in the projectnpx briefatto-board adopt .
A build in another foldernpx briefatto-board adopt . --root dist
Running on a dev servernpx briefatto-board adopt . --page http://localhost:3000/ --page http://localhost:3000/docs

Captures are desktop and mobile by default. Repeat --viewport WIDTHxHEIGHT for other sizes. Leave a running site running for the freeze.

What the agent reads

The capture is evidence, and your agent does the reading. The skill tells it to open each screenshot in .briefatto/adoption/, read evidence.json for computed styles, visible copy and candidate style files, and inspect the page source, CSS variables, Tailwind configuration, theme and logo files those pages use.

From that it writes DESIGN.md as a designer's handoff: layout, spacing, navigation, components and logo by role, the voice from the real copy, and how the layout recomposes on other canvases.

Freeze turns notes into a record

npx briefatto-board freeze . records the exact styles of a fresh render in a generated block, checks the prose against them and names any conflicting value. The guide is stamped as v1 and archived.

When the site changes, capture again and freeze the next version. board log shows the history and board diff v1 v2 shows what moved.

Questions and answers

Does it capture the mobile layout?

Yes. The default captures are desktop and mobile, and --viewport adds any other size you name.

Can I fix problems before I extract?

Yes. board adopt . --check runs the floor on the selected pages; the agent shows the findings and proposed fixes and waits for your yes before it fixes, recaptures and freezes.

Which agent writes the DESIGN.md?

The one you already use. Briefatto Board works with any coding agent that reads AGENTS.md and runs shell commands: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and the rest.

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/src/board/cli.ts
  4. github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
  5. nextjs.org/docs/app/api-reference/cli/next checked 2026-11-21
  6. vite.dev/config/build-options checked 2026-11-21