Agents

The instruction files (AGENTS.md, CLAUDE.md, .github/copilot-instructions.md) we ship in our repos to guide AI coding assistants.

No entries yet. Be the first — run ./scripts/toolbelt-add.sh and pick agent. Or copy _templates/agent.md into a new file here.

What belongs here

• A snapshot + commentary on each repo's agent instruction file
• The reasoning behind each non-obvious rule (link to past incidents/PRs)
• Cross-repo patterns we've standardised on

Why mirror the live files here

• Searchability: one place to find "do we have a rule about X anywhere?"
• Onboarding: new team members can read all our conventions in one sitting
• Cross-pollination: when you write a new rule for repo A, check if it should also live in repo B