AGENTS.md 是一个用于指导编程智能体（coding agent）的开放格式。官网把它定位为「智能体看的 README」：README.md 面向人类（快速上手、项目介绍、贡献指南），AGENTS.md 补充智能体需要的细节上下文，例如构建步骤、测试命令与代码约定。官网称其已被 6 万多个开源项目使用。
与 README 的分工
官网强调二者互补而非替代。单独设一个文件的理由是：给智能体一个固定、可预期的指令位置；让 README 保持精简、聚焦人类贡献者；提供面向智能体的精确指引。
格式与解析
没有必填字段，就是标准 Markdown，标题随意写，智能体直接解析你提供的文本。指令冲突时，离当前编辑文件最近的那份 AGENTS.md 优先。大型 monorepo 可以在每个子包里各放一份，智能体自动读取目录树上最近的文件；官网举例称 OpenAI 主仓库当时有 88 份 AGENTS.md。
生态与治理
官网列出的兼容工具包括 OpenAI Codex、Google Jules 与 Gemini CLI、Cursor、GitHub Copilot、Devin、Aider、Zed、Warp 等。该格式由 AI 软件开发生态多方协作形成（官网点名 OpenAI Codex、Amp、Google Jules、Cursor、Factory），现由 Linux 基金会下的 Agentic AI Foundation 托管。
适用边界
AGENTS.md 只是「把指令放在哪里」的约定，本身不含强制机制，也不构成权限或安全控制手段。