The convention for telling AI coding agents how to work in your repo
AGENTS.md is the cross-vendor markdown file that AI coding agents (Claude Code, Cursor, Codex, Aider, etc.) read for repo-specific instructions, conventions, and constraints. The de-facto spec for codifying your team's preferences so every agent behaves the same.
Spec writing, API design, architecture diagrams, and contract-first tooling — the upstream layer before code is written
AIchitect's Genome scanner detects AGENTS.md in your project via these signals:
AGENTS.md● No incidents in the last 90 days
Add to your GitHub README
[](https://www.aichitect.dev/tool/agents-md)Explore the full AI landscape
See how AGENTS.md fits into the bigger picture — browse all 207 tools and their relationships.