Briefatto LabBriefatto Lab

Questions

Does Claude Code read DESIGN.md automatically?

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.

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

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

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.

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. code.claude.com/docs/en/memory checked 2026-11-21
  2. agents.md checked 2026-11-21
  3. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  4. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  5. github.com/Briefatto/briefatto-board/blob/main/README.md
  6. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  7. github.com/Briefatto/briefatto-board/blob/main/LICENSE