Briefatto LabBriefatto Lab

Questions

How do you keep design context across different AI coding tools?

Keep the design in one file, DESIGN.md, and point every tool's instruction file at it. Briefatto Board writes that pointer to AGENTS.md and CLAUDE.md, the files Claude Code, Cursor, Codex, Copilot and OpenCode document for instructions, and puts its skill in .claude/skills/.

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

One file, many readers

  • Claude Code reads CLAUDE.md or AGENTS.md and loads skills from .claude/skills/.
  • Cursor lists AGENTS.md as agent instructions and also loads skills from .claude/skills/.
  • Codex has a guide for custom instructions with AGENTS.md.
  • GitHub Copilot reads AGENTS.md files anywhere in the repository.
  • OpenCode reads AGENTS.md and searches .claude/skills for compatibility.
  • Devin (Windsurf) and Kiro document AGENTS.md support.
  • Gemini CLI reads AGENTS.md once you list it under context.fileName in settings.json.

Each tool's own page is in Works with your agent.

Why one versioned file

When every tool reads the same DESIGN.md, a brand change happens once. Freeze it as the next version, see what changed with board diff v1 v2, and board status lists which pieces still declare the old one, whichever tool made them.

Questions and answers

Do I need a different design file for each tool?

No. Briefatto Board keeps one DESIGN.md and writes the same pointer to AGENTS.md and CLAUDE.md.

Which tools does it work with?

Any coding agent that reads AGENTS.md and runs shell commands.

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. cursor.com/docs/context/rules checked 2026-11-21
  6. cursor.com/docs/skills checked 2026-11-21
  7. developers.openai.com/codex/guides/agents-md checked 2026-11-21
  8. agents.md checked 2026-11-21
  9. docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions checked 2026-11-21
  10. opencode.ai/docs/rules/ checked 2026-11-21
  11. opencode.ai/docs/skills/ checked 2026-11-21
  12. docs.devin.ai/desktop/cascade/agents-md checked 2026-11-21
  13. kiro.dev/docs/steering/ checked 2026-11-21
  14. geminicli.com/docs/cli/gemini-md/ checked 2026-11-21
  15. github.com/Briefatto/briefatto-board/blob/main/LICENSE