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

Updated 2026-11-21 · https://briefatto.com/guides/one-design-guide-across-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/`.

## 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](https://briefatto.com/guides/).

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

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [AGENTS.md vs CLAUDE.md: which file should hold your design rules?](https://briefatto.com/guides/agents-md-vs-claude-md/)
- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)
- [Does Briefatto Board work with my coding agent?](https://briefatto.com/guides/does-it-work-with-my-coding-agent/)
- [How do you keep one brand across many AI agents and teammates?](https://briefatto.com/guides/one-brand-across-many-agents-and-teammates/)
- [Cursor + Briefatto Board: on-brand UI from one DESIGN.md](https://briefatto.com/guides/cursor-briefatto-board/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://code.claude.com/docs/en/memory (checked 2026-11-21)
- https://cursor.com/docs/context/rules (checked 2026-11-21)
- https://cursor.com/docs/skills (checked 2026-11-21)
- https://developers.openai.com/codex/guides/agents-md (checked 2026-11-21)
- https://agents.md (checked 2026-11-21)
- https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions (checked 2026-11-21)
- https://opencode.ai/docs/rules/ (checked 2026-11-21)
- https://opencode.ai/docs/skills/ (checked 2026-11-21)
- https://docs.devin.ai/desktop/cascade/agents-md (checked 2026-11-21)
- https://kiro.dev/docs/steering/ (checked 2026-11-21)
- https://geminicli.com/docs/cli/gemini-md/ (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
