Briefatto LabBriefatto Lab

Questions

DESIGN.md vs AGENTS.md: what goes in each file

AGENTS.md carries a short block that points the agent to your design guide, and DESIGN.md holds the guide itself and its versions. Briefatto Board writes the block into AGENTS.md for you and keeps DESIGN.md as a separate, frozen file.

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

What each file is for

AGENTS.mdDESIGN.md
RoleInstructions that coding agents readYour project's design guide
Briefatto Board's partA marked block with the pointer, written by board install and updated by board freezeAuthored prose plus a generated block of exact styles, stamped with a version by board freeze
Read byThe agents that read AGENTS.md, which agents.md listsYour agent, because the AGENTS.md block tells it to

The same block is also written to CLAUDE.md.

Questions and answers

Can I put the design guide inside AGENTS.md?

Keep them apart. The AGENTS.md block is a pointer; the guide lives in DESIGN.md so that board freeze can version and validate it.

Does Briefatto Board overwrite my AGENTS.md?

No. It writes a marked block between start and end comments and edits only that block.

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. agents.md checked 2026-11-21
  5. code.claude.com/docs/en/memory checked 2026-11-21
  6. github.com/Briefatto/briefatto-board/blob/main/LICENSE