# Does Claude Code read DESIGN.md automatically?

Updated 2026-11-21 · https://briefatto.com/guides/does-claude-code-read-design-md/

Claude Code reads CLAUDE.md and AGENTS.md, not DESIGN.md. Briefatto Board's installer writes a block into both files that sends Claude Code to DESIGN.md before any visual work.

## How Claude Code finds the guide

Run `npx briefatto-board install`. It adds a marked block to CLAUDE.md and AGENTS.md. After `board freeze`, the block says to read `DESIGN.md` before any visual work and to run `board check` on every piece before handing it over.

The pointer sits in CLAUDE.md and AGENTS.md because Claude Code's [memory documentation](https://code.claude.com/docs/en/memory) names those files for persistent instructions.

## Then check what it made

`board check` is a program that renders each piece and fails it for clipped text, text off the canvas, text over other text, text too small where it is seen, fonts that never loaded and contrast below WCAG. See [how to make an agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/).

## Questions and answers

### Do I need to mention DESIGN.md in CLAUDE.md myself?

No. The installer writes the block, and `board freeze` updates it.

### Does the same pointer work for other agents?

Yes. The block goes into AGENTS.md too, which many coding agents read.

### 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/)
- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)
- [CLAUDE.md vs DESIGN.md: what to put in each for Claude Code](https://briefatto.com/guides/claude-md-vs-design-md/)
- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)

## Sources

- https://code.claude.com/docs/en/memory (checked 2026-11-21)
- https://agents.md (checked 2026-11-21)
- 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/src/board/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
