Briefatto LabBriefatto Lab

Questions

AGENTS.md vs CLAUDE.md: which file should hold your design rules?

Put a short pointer in both files and keep the design itself in DESIGN.md. npx briefatto-board install writes the same marked block to AGENTS.md and CLAUDE.md, so Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and the other agents that read either file get the same instruction.

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

Which agent reads which file

AgentWhat its documentation says
Claude CodePersistent instructions through CLAUDE.md or AGENTS.md files.
CodexCustom instructions with AGENTS.md.
CursorAGENTS.md as a plain-markdown alternative to .cursor/rules.
GitHub CopilotAGENTS.md files anywhere in the repository; the nearest one takes precedence.
OpenCodeAGENTS.md, and CLAUDE.md in any directory without one.
LovableAGENTS.md or CLAUDE.md at the top level, read with every message.

One block, both files, one guide

The Briefatto Board block sits between <!-- briefatto-board:start --> and <!-- briefatto-board:end --> in each file. After a freeze it tells the agent to read DESIGN.md before any visual work, to route brand changes through board freeze and to run board check on every piece.

Running the installer again replaces that one block instead of adding a second, so the files never disagree.

Questions and answers

Will it overwrite my CLAUDE.md?

No. It adds one marked block and leaves the rest of the file as it is.

Why not put the whole design system in AGENTS.md?

The instruction files load in every session. A short pointer keeps them small, and the guide in DESIGN.md is frozen, versioned and checked against a render.

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/skill/briefatto-board/board.mjs
  4. code.claude.com/docs/en/memory checked 2026-11-21
  5. agents.md checked 2026-11-21
  6. developers.openai.com/codex/guides/agents-md checked 2026-11-21
  7. cursor.com/docs/context/rules checked 2026-11-21
  8. docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions checked 2026-11-21
  9. opencode.ai/docs/rules/ checked 2026-11-21
  10. docs.lovable.dev/features/knowledge checked 2026-11-21
  11. github.com/Briefatto/briefatto-board/blob/main/LICENSE