# How to create a DESIGN.md from your site or a new brand

Updated 2026-11-21 · https://briefatto.com/guides/how-to-create-a-design-md/

For an existing site, run `npx briefatto-board adopt .`, let your agent write DESIGN.md from the captures and freeze it with `npx briefatto-board freeze .`. For a new brand, put the brief in brief.md and go from references to directions to a pick to a freeze.

## From the site you already have

```sh
npx briefatto-board adopt .
npx briefatto-board freeze .
```

`adopt` captures your pages and their computed styles, desktop and mobile. It finds top-level HTML pages or a conventional build with an index page; for a running site, pass `--page <url>` for each representative route.

Your agent writes DESIGN.md from the captures. `freeze` records exact styles from a fresh render, validates the prose against them and stamps the guide as v1.

## From a brief

Put the brief in `brief.md` and ask your agent to follow the skill. It shows you a reference sheet, draws three directions from your picks, revises the one you choose and writes the design guidance after your yes.

```sh
npx briefatto-board refs .
npx briefatto-board directions .
npx briefatto-board freeze . lead
```

Use your chosen direction's ID in place of `lead`. Briefatto Board needs Node.js 24 or later; the first render prints the Playwright command to install Chromium if it is missing.

## Questions and answers

### Does the tool write the prose for me?

Your agent writes it, from the captures or the chosen direction. Freeze records the exact values and validates the prose against them.

### What does freeze do?

It records source wording and exact styles from a fresh render, validates the authored guidance, stamps and archives the guide, and tells future sessions to read it first.

### Can I adopt a site that only runs on a dev server?

Yes. Pass `--page <url>` to `board adopt` for each representative route.

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

- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)
- [How to make Claude Code follow your brand with DESIGN.md](https://briefatto.com/guides/how-to-use-design-md-in-claude-code/)
- [What happens when you change a colour or font in DESIGN.md?](https://briefatto.com/guides/what-happens-when-you-change-a-design-md-token/)
- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
