Source: AGENTS.md (open format site)
The AGENTS.md site: a plain-Markdown 'README for agents' adopted by 60k+ repos and many coding agents, now stewarded by the Agentic AI Foundation under the Linux Foundation.
Contents
- What: format specification / project website
- Publisher: AGENTS.md project (a Series of LF Projects; stewarded by the Agentic AI Foundation)
- Date: living site, read 2026-11-14
- Original: agents.md
Summary
AGENTS.md is a convention, not a schema: a Markdown file at the repository root (and optionally in subdirectories) holding the build, test and convention knowledge an agent needs but that would clutter a human README. It emerged from collaboration between OpenAI Codex, Amp, Google Jules, Cursor and Factory.
Key claims
- No required fields. Suggested sections: project overview, build and test commands, code style, testing instructions, security considerations, commit/PR guidelines, deployment.
- Monorepos can nest files per package; agents use the nearest file in the tree, and explicit chat prompts override all AGENTS.md content. The OpenAI main repo reportedly has 88 of them.
- Reported adoption: over 60k open-source projects (as of 2026-11).
- Supporting tools listed include OpenAI Codex, Jules, Aider, goose, opencode, Zed, Warp, VS Code, Devin, JetBrains Junie, Amp, Cursor, RooCode, Gemini CLI, GitHub Copilot’s coding agent and Windsurf.