Briefatto LabBriefatto Lab

Questions

How do you improve Claude Code's frontend design?

Start with what Claude Code already built: npx briefatto-board adopt . --check runs the floor on your current pages, the agent proposes fixes and waits for your yes, and the repaired look is frozen as DESIGN.md so every later session builds from it.

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

Measure the pages you have

Claude Code's frontend gets fixed one finding at a time, and the findings come from the rendered page. Start the app, then capture the routes that carry the brand:

shell
npx briefatto-board install
npx briefatto-board adopt . --check --page http://localhost:3000/ --page http://localhost:3000/pricing

--check runs the floor on each selected page: clipped text, text off the canvas or over other text, type too small where it is seen, fonts that never loaded, contrast below WCAG, and the Impeccable detector's anti-patterns. Captures are desktop and mobile by default. Static files or a build folder work too, with --root <dir>.

Fix, recapture, freeze

  1. Claude Code shows you the findings and the fixes it proposes, then waits for your yes.
  2. It fixes the agreed issues and reruns the capture and the floor.
  3. It writes DESIGN.md from the revised pages: screenshots in .briefatto/adoption/, computed styles in evidence.json, your CSS variables, Tailwind configuration and logo files.
  4. npx briefatto-board freeze . --check stamps the guide only when the floor passes as well as the guide validation.

Hold every new screen to the repaired look

After the freeze, the block in CLAUDE.md and AGENTS.md tells Claude Code to read DESIGN.md before any visual work and to run board check on every piece before handing it over. A failing piece sets exit status 1, which the agent reads as a fault to fix before hand-over, and which stops a pre-commit hook or CI run.

Add --consistency to board check on a kit format and it lists every colour off the frozen palette, each with its nearest frozen colour, plus fonts outside the guide.

Questions and answers

Will Claude Code redesign the whole app?

No. It proposes fixes and waits for your yes, and for feedback on one piece it edits only that piece. After a brand change, board status lists what needs revisiting and nothing is redrawn behind your back.

Do I need a design file before I start?

No. board adopt captures the pages and Claude Code writes DESIGN.md from what it sees. You review it before it is frozen.

Does this work with a Next.js or Vite dev server?

Yes. Pass each route's URL with --page, for example http://localhost:3000/ on Next.js, and leave the server running for the freeze.

What if I like the current look?

Skip --check. Run npx briefatto-board adopt ., let Claude Code write the guide, and freeze it with npx briefatto-board freeze . to keep the look exactly as it renders.

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/skill/briefatto-board/SKILL.md
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  3. github.com/Briefatto/briefatto-board/blob/main/README.md
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  5. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  6. nextjs.org/docs/app/api-reference/cli/next checked 2026-11-21