Briefatto LabBriefatto Lab

Questions

How do you make an AI agent's new page match your existing site?

Freeze the site you have before you ask for the new page: board adopt and board freeze record its look in DESIGN.md, the agent builds from that record, and board check notes every colour and font the current guide does not contain.

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

Before you ask

shell
npx briefatto-board install
npx briefatto-board adopt .
npx briefatto-board freeze .

Adopt captures the pages and computed styles, your agent writes DESIGN.md from them, and freeze records the exact styles of a fresh render beside the prose. From then on the block in AGENTS.md and CLAUDE.md tells the agent to read DESIGN.md before any visual work. The new section starts from your site instead of the agent's defaults.

After the draft

Give the new piece its own file, such as outputs/pricing-section.html, and check it:

shell
npx briefatto-board check . outputs/pricing-section.html

On a frozen board the check adds a note for every painted colour and every font that is not in the current guide. When a value belongs to an earlier version, the note names the version and the role it had there.

On a real site

Our blind test used Issue Composer, a public open-source tool with one marketing page. One of the three requests was exactly this job: a new landing-page section for a release the site had never shown. In that test on one real open-source project, against kits made with Hallmark, Taste Skill and Impeccable from the same commit, all four blind judges ranked the Briefatto Board kit first.

The highlight, tilted card and eyebrow make it look like a continuation of the existing site, and the three pieces clearly belong together.

one blind judge

See every kit side by side.

Questions and answers

My current site has problems. Will the agent copy them?

Fix them first. board adopt . --check runs the floor on the selected pages; the agent proposes fixes, waits for your yes, then recaptures and freezes the repaired look.

Does it work on a running app?

Yes. Pass each route with --page, such as http://localhost:3000/ on a Next.js dev server, and leave it running for the freeze.

Will the agent restyle my old pages while it adds the new one?

No. The guide records the old pages; the new piece is made and checked on its own, and nothing is redrawn behind your back.

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/src/board/standing.ts
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  5. github.com/jalopezsuarez/issue-composer/tree/151bb54eb155e7eafd93e26086e0ad91f80b7dc7 checked 2026-11-21
  6. github.com/jalopezsuarez/issue-composer/blob/151bb54eb155e7eafd93e26086e0ad91f80b7dc7/LICENSE checked 2026-11-21
  7. jalopezsuarez.github.io/issue-composer/web/ checked 2026-11-21
  8. nextjs.org/docs/app/api-reference/cli/next checked 2026-11-21