Briefatto LabBriefatto Lab

Questions

CLAUDE.md vs DESIGN.md: what to put in each for Claude Code

CLAUDE.md carries your general instructions and a short pointer, and DESIGN.md holds the design guide. Briefatto Board writes that pointer into CLAUDE.md and AGENTS.md for you and keeps the guide in a versioned DESIGN.md.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.md

The split

  • CLAUDE.md: your project's general instructions, plus the Briefatto Board block, which tells Claude Code to read DESIGN.md before visual work.
  • DESIGN.md: the design guide, with authored prose and a generated block of exact styles, stamped with a version by board freeze.

With the guide out of CLAUDE.md, a brand change is one frozen, versioned file change, and board diff v1 v2 shows it.

Questions and answers

Should I paste my colours and fonts into CLAUDE.md?

No. board freeze records exact styles from a render into DESIGN.md, so nobody copies them by hand.

Does the pointer go into AGENTS.md as well?

Yes. The installer writes the same block to AGENTS.md and CLAUDE.md.

Is Briefatto Board free?

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

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  2. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  3. github.com/Briefatto/briefatto-board/blob/main/README.md
  4. code.claude.com/docs/en/memory checked 2026-11-21
  5. github.com/Briefatto/briefatto-board/blob/main/LICENSE