# How to make Claude Code follow your brand with DESIGN.md

Updated 2026-11-21 · https://briefatto.com/guides/how-to-use-design-md-in-claude-code/

Run `npx briefatto-board install` and freeze your brand as DESIGN.md: the installer puts the Briefatto Board skill under `.claude/skills/` and writes a block into CLAUDE.md and AGENTS.md that tells Claude Code to read DESIGN.md before visual work. Every piece it makes is then checked on its rendered output with `board check`.

## What the install writes

The skill goes under `.claude/skills/`, which is where Claude Code loads skills from, and a marked block goes into both CLAUDE.md and AGENTS.md, the files Claude Code's documentation names for persistent instructions.

After `board freeze`, the block tells Claude Code to read `DESIGN.md` before any visual work, to route brand changes through `board freeze`, and to run `board check` on every piece before handing it over.

## Or install it as a Claude Code plugin

The repository ships a Claude Code plugin manifest and a marketplace named briefatto.

```text
/plugin marketplace add Briefatto/briefatto-board
/plugin install briefatto-board@briefatto
```

## Blind-tested

In a blind test on one real open-source project, all 4 of 4 judges ranked the Briefatto Board kit first overall, ahead of Impeccable, Taste Skill and Hallmark. See [the blind test](https://briefatto.com/guides/impeccable-vs-taste-skill-vs-hallmark-blind-test/).

## Questions and answers

### Does Claude Code read DESIGN.md by itself?

Claude Code reads CLAUDE.md and AGENTS.md. The block that `board install` writes there tells it to read DESIGN.md. See [does Claude Code read DESIGN.md](https://briefatto.com/guides/does-claude-code-read-design-md/).

### Where does the skill go?

Under `.claude/skills/`, where Claude Code loads skills.

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

- [Does Claude Code read DESIGN.md automatically?](https://briefatto.com/guides/does-claude-code-read-design-md/)
- [CLAUDE.md vs DESIGN.md: what to put in each for Claude Code](https://briefatto.com/guides/claude-md-vs-design-md/)
- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)
- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)

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