# Do I need DESIGN.md if I already have AGENTS.md or CLAUDE.md?

Updated 2026-11-21 · https://briefatto.com/guides/do-i-need-design-md-if-i-have-agents-md/

Yes: AGENTS.md and CLAUDE.md carry instructions, and the brand belongs in its own versioned DESIGN.md. Briefatto Board adds a marked pointer block to your instruction files and freezes the guide.

## Why the brand gets its own file

A design guide changes when the brand changes, and you want to know which version each piece was made under. A separate DESIGN.md is stamped with a version by `board freeze` and compared with `board diff v1 v2`.

Your instruction files stay yours. The installer adds a block between `<!-- briefatto-board:start -->` and `<!-- briefatto-board:end -->` and edits only that block.

## Questions and answers

### What if I only have a CLAUDE.md?

The installer writes the block to both AGENTS.md and CLAUDE.md.

### Will my existing instructions be changed?

No. Briefatto Board edits only its own marked block.

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

- [DESIGN.md vs AGENTS.md: what goes in each file](https://briefatto.com/guides/design-md-vs-agents-md/)
- [CLAUDE.md vs DESIGN.md: what to put in each for Claude Code](https://briefatto.com/guides/claude-md-vs-design-md/)
- [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/)

## Sources

- 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/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
