AGENTS.md is a plain-text file at the root of your repository that describes your
project to any AI coding agent: architecture, conventions, what to touch and what to
leave alone. Quorum detects it automatically when you open a workspace.
Why it matters
A fresh agent session starts with zero context about your codebase. Without a context
file, you re-explain the same conventions every session. AGENTS.md makes that context
persistent — it survives reloads, new terminals, and tool switches.
What to put in it
- Architecture — the high-level shape of the project and where things live.
- Conventions — naming, formatting, testing expectations.
- Guardrails — files or directories the agent should never modify.
- Commands — how to run, test, and build.
Autoload
When you open a folder in Quorum, it loads AGENTS.md from the repo root and wires
CLAUDE.md to it (via an @AGENTS.md import), so Claude Code reads the same instructions.
No configuration required — drop the file in and every agent terminal picks it up. Keep
companion files like STRUCTURE.json in the same root and point to them from AGENTS.md.
Tip: keep
AGENTS.mdunder version control so the whole team shares the same context.
Something off on this page? Tell us.