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 is | Run |
|---|---|
| Static HTML in the project | npx briefatto-board adopt . |
| A build in another folder | npx briefatto-board adopt . --root dist |
| Running on a dev server | npx 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.