What each file is for
| AGENTS.md | DESIGN.md | |
|---|---|---|
| Role | Instructions that coding agents read | Your project's design guide |
| Briefatto Board's part | A marked block with the pointer, written by board install and updated by board freeze | Authored prose plus a generated block of exact styles, stamped with a version by board freeze |
| Read by | The agents that read AGENTS.md, which agents.md lists | Your 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.