{
 "acronym": "",
 "adoption": {
  "by": "agents.md (site claims over 60,000 AGENTS.md files across open-source GitHub repositories, via a `path:AGENTS.md NOT is:fork NOT is:archived` code search)",
  "level": "claimed",
  "probe_run": null
 },
 "aliases": [],
 "analog": "CONTRIBUTING.md / a repository's contributor instructions, but written for an agent instead of a human contributor",
 "collisions": [
  "AGENT.md (legacy pre-merge filename some tools symlink for backward compatibility)"
 ],
 "discovery": {
  "mechanism": "Fixed filename at a repository's root; agents read the nearest AGENTS.md up the directory tree from the file being edited, so a nested file in a monorepo package takes precedence over the root file",
  "path": "AGENTS.md"
 },
 "dispute": null,
 "evidence": [
  {
   "claim": "Full AGENTS.md rationale, format (no required fields, closest-file-wins precedence), FAQ, migration guidance, and current list of 25+ adopting tools (Codex, Amp, Jules, Cursor, Factory, Devin, Aider, goose, Ona, VS Code, Zed, Windsurf, GitHub Copilot coding agent, Warp, Junie, RooCode, Phoenix, Augment Code, Kilo Code, opencode, and more). \"AGENTS.md is now stewarded by the Agentic AI Foundation under the Linux Foundation\".",
   "date": "2026-09",
   "label": "VERIFIED",
   "url": "https://agents.md"
  },
  {
   "claim": "AGENTS.md was released by OpenAI in August 2025, emerging from collaboration across OpenAI Codex, Amp, Jules (Google), Cursor, and Factory",
   "date": "2026",
   "label": "REPORTED",
   "url": "https://blog.stackademic.com/agents-md-the-readme-your-ai-coding-agent-actually-reads-e634b7e2de34"
  },
  {
   "claim": "OpenAI's own harness-engineering writeup for the Codex repository references \"the initial AGENTS.md file that directs agents how to work in\" the repo, corroborating OpenAI's originating role",
   "date": "2026",
   "label": "REPORTED",
   "url": "https://openai.com/index/harness-engineering/"
  }
 ],
 "form": "well-known-file",
 "governance": "Agentic AI Foundation (AAIF), a Linux Foundation project",
 "group": null,
 "history": [
  {
   "date": "2026-09-05",
   "note": "seeded from Exa Agent research run"
  },
  {
   "date": "2026-09-06",
   "note": "verified against agents.md, OpenAI's harness-engineering post, and a secondary account of the August 2025 launch"
  }
 ],
 "id": "agents-md",
 "implementation": "multi-implementation",
 "last_verified": "2026-09-06",
 "name": "AGENTS.md",
 "native_status": "\"An open format... regardless of which coding agent you use\"; explicitly not proprietary to any one tool",
 "origin": {
  "date": "2025-08",
  "org": "OpenAI (Codex team), in collaboration with Amp, Google (Jules), Cursor, and Factory"
 },
 "part_of": null,
 "parties": [
  "agent-site"
 ],
 "phase": "living",
 "probe": {
  "method": "GET",
  "on_absent": "No repository-level agent instructions are declared; an agent falls back to inferring conventions from the codebase or README",
  "parse": "200 response containing markdown text; presence alone is the signal since there are no required fields or schema",
  "path": "{origin}/AGENTS.md (repository-root fetch, e.g. raw.githubusercontent.com/<owner>/<repo>/HEAD/AGENTS.md)"
 },
 "question": "What build, test, and convention instructions should a coding agent follow in this repository?",
 "scope": "coding-tools",
 "spec_url": "https://agents.md",
 "step": "read",
 "summary_md": "AGENTS.md is an open convention for a markdown file placed at a repository's root (or nested inside subpackages) that gives coding agents the operational context a human-facing README would clutter: build and test commands, code-style rules, security considerations, and PR conventions [1]. It complements, rather than replaces, README.md: the README stays focused on human contributors while AGENTS.md carries agent-specific detail [1].\n\nIt solves the problem of giving many different coding agents — Codex, Claude Code, Cursor, Copilot, and dozens of others — one predictable, tool-agnostic place to find per-repository instructions, instead of every vendor inventing its own proprietary rules file (`.cursorrules`, `CLAUDE.md`, etc., some of which are still separately supported alongside it). It has no required fields or schema: \"AGENTS.md is just standard Markdown. Use any headings you like; the agent simply parses the text you provide\" [1]. In a monorepo, nested AGENTS.md files are supported and the closest file to the edited path wins, letting each subproject carry tailored instructions; the OpenAI repository itself reportedly has 88 such files [1].\n\nIt does not enforce anything: whether an agent actually runs the test commands it lists is a matter of each tool's own behavior, and explicit user chat instructions always override the file's contents [1]. It is not a machine-readable manifest (no capability declarations, no discovery well-known path) — it is read as freeform prose, closer to documentation than to a protocol.\n\nCurrent state: the format launched in August 2025, originating from OpenAI's Codex team working with Amp, Google's Jules, Cursor, and Factory [1][2][3]. As of this verification (September 2026) it is stewarded by the Agentic AI Foundation (AAIF), a Linux Foundation project, and is supported by more than two dozen coding tools and agents, including several that also support a proprietary rules file of their own alongside it (Zed, Windsurf, RooCode, Kilo Code, opencode) [1]. The project's own site claims over 60,000 AGENTS.md files exist across public, non-fork, non-archived GitHub repositories, based on a GitHub code search rather than an independent crawl [1].\n\nWhat is disputed or unknown: the 60,000+ figure is a claim by the format's own stewards, not an independently reproduced count, and no third-party adoption study analogous to the llms.txt Tranco studies was found during this verification. It is also unclear how much of AAIF's governance is substantive versus a naming step shortly after Linux Foundation involvement was announced (2026), since the specification text itself has not visibly changed in structure since the original release.",
 "track": "linux-foundation",
 "version": {
  "date": "2026-09",
  "label": "current site guidance (living document)"
 },
 "url": "https://agenticweb.wiki/protocols/agents-md/",
 "category": "read",
 "type": "protocol"
}