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

Updated 2026-11-21 · https://briefatto.com/guides/make-new-pages-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.

## Before you ask

```sh
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:

```sh
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](https://briefatto.com/guides/impeccable-vs-taste-skill-vs-hallmark-blind-test/).

## 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.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [How do you extract a design system from an existing website?](https://briefatto.com/guides/extract-design-system-from-a-website/)
- [What does DESIGN.md solve when AI-generated UI keeps drifting?](https://briefatto.com/guides/ai-ui-keeps-drifting/)
- [Design docs drift from the real design: how freeze stops it](https://briefatto.com/guides/design-docs-drift-from-the-real-design/)
- [How to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)
- [Briefatto Board vs Impeccable, Taste Skill and Hallmark: the blind test](https://briefatto.com/guides/impeccable-vs-taste-skill-vs-hallmark-blind-test/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
- https://github.com/jalopezsuarez/issue-composer/tree/151bb54eb155e7eafd93e26086e0ad91f80b7dc7 (checked 2026-11-21)
- https://github.com/jalopezsuarez/issue-composer/blob/151bb54eb155e7eafd93e26086e0ad91f80b7dc7/LICENSE (checked 2026-11-21)
- https://jalopezsuarez.github.io/issue-composer/web/ (checked 2026-11-21)
- https://nextjs.org/docs/app/api-reference/cli/next (checked 2026-11-21)
