# How do you create brand guidelines with Claude Code?

Updated 2026-11-21 · https://briefatto.com/guides/claude-code-brand-guidelines/

Install Briefatto Board and ask Claude Code to follow its skill: from a brief it draws three directions for you to choose from, and from an existing site it writes the guide from captures of your pages. Either way the guidelines end up in a frozen DESIGN.md that CLAUDE.md tells every later session to read.

## From a brief

Write `brief.md`. Claude Code shows a reference sheet, draws three distinct directions with your real copy and a designed wordmark in each, revises the one you pick and writes the guidelines after your yes. See [start a brand with an AI agent](https://briefatto.com/guides/start-a-brand-with-an-ai-agent/).

## From your site

Run `npx briefatto-board adopt .`. Claude Code reads the captures and computed styles and writes DESIGN.md as a designer's handoff. `npx briefatto-board freeze .` stamps it as v1.

## What the guidelines hold

- Layout, spacing, navigation, components and logo, described by role.
- The voice and example copy, taken from the real pages or the brief.
- Typography, with the font load lines.
- A generated block with Brand facts, Campaign copy, Client musts and must-nots and the exact computed styles.

## Questions and answers

### Where does Claude Code keep the guidelines?

In DESIGN.md at the project root. The block in CLAUDE.md and AGENTS.md tells every session to read it before visual work.

### Can I change them later?

Yes. Update DESIGN.md and freeze again with a note; `board status` then lists what still needs revisiting.

### Is Briefatto Board free?

Yes. It is open source under the Apache-2.0 licence and installs with `npx briefatto-board install`.

## 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 to make Claude Code follow your brand with DESIGN.md](https://briefatto.com/guides/how-to-use-design-md-in-claude-code/)
- [How do you start a brand with an AI agent when there is none yet?](https://briefatto.com/guides/start-a-brand-with-an-ai-agent/)
- [How do you make a brand kit with Claude Code?](https://briefatto.com/guides/claude-code-brand-kit/)
- [Why does every site Claude Code builds look the same?](https://briefatto.com/guides/why-claude-code-sites-look-the-same/)

## 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://code.claude.com/docs/en/skills (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
