AGENTS.md 是位于环境中的文件，由运行框架在会话开始时加载进上下文窗口；它相当于项目长期提供给智能体的工作简报。这是一项跨运行框架约定，某些框架也有自己的变体，例如 Claude Code 使用 CLAUDE.md。
因为它会自动加载，所以可以帮助你避免在不同会话中反复解释。模型是无状态的——一次会话中的纠正不会保留到下一次，于是你不得不告诉每个新会话：项目使用 pnpm、测试必须带某个选项运行、某个目录由工具生成不得修改。当你已经针对同一件事纠正智能体两次，这条纠正就适合写进 AGENTS.md。
适合写入的内容，是智能体无法直接从代码推导出的信息：构建和测试命令、代码库中不明显的约定，以及“绝不修改生成的客户端”这类硬性约束。内容应简短、直接陈述——它是一份简报，不是完整文档。
代价是其中所有内容都会始终加载。指令不断累积，而大部分对任一具体任务都无关；过长的 AGENTS.md 既消耗 Token，也会稀释自身效果——上下文中的指令越多，模型可靠遵循其中任意一条的概率就越低。
避免：把本应渐进式披露的内容写进 AGENTS.md。无论会话是否需要，其中每项内容都会在每个会话的每个轮次支付 Token 成本。样式指南可以放在技能或上下文指针之后；AGENTS.md 只保留适用于所有场景的规则。
用法：
“为什么每次会话刚开始就已经消耗了 4k Token？”
“检查 AGENTS.md——有人把整份样式指南粘了进去，而不是放在技能后面按需加载。”