How it fits a Next.js and Tailwind project
- Claude Code's documentation describes persistent instructions through CLAUDE.md or AGENTS.md, and it loads skills from
.claude/skills/. Briefatto Board writes its block to both files and its skill to that folder. - Next.js serves the app on http://localhost:3000 by default during development.
board adoptcaptures a running site from the URLs you pass. - Tailwind theme variables defined with
@themebecome regular CSS variables. The skill tells Claude Code to inspect those CSS variables and your Tailwind configuration, and freeze records the computed styles your pages render.
Set it up
Start the dev server with next dev and leave it running. Then, in the project folder:
npx briefatto-board install
npx briefatto-board adopt . --page http://localhost:3000/ --page http://localhost:3000/pricing
npx briefatto-board freeze .Between adopt and freeze, ask Claude Code to write DESIGN.md from the captures in .briefatto/adoption/. Pass a --page for each representative route and state; the default captures are desktop and mobile.
Static export instead
With output: "export" in next.config.js, next build creates an out folder with one HTML file per route. Adopt it directly: npx briefatto-board adopt . --root out.
What Claude Code gets
- One versioned guide. DESIGN.md is frozen as v1, v2 and on.
- A check on every piece.
board checkfails clipped text, small text, unloaded fonts and low contrast. - A stale list after a rebrand.
board statuslists which pieces are current, stale or unrecorded.
Questions and answers
Which routes should I pass to adopt?
The representative routes and states that carry the brand, such as the home page, a content page and a form. Repeat --page for each.
Does it read my Tailwind theme?
Yes. The skill tells Claude Code to inspect your Tailwind configuration and CSS variables, and freeze records the styles they produce on the rendered pages.
Do I need the dev server running for freeze?
Yes. Leave the site running from adopt through freeze, because freeze records styles from a fresh render.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.