上下文资源稀缺。 巨大的说明文件会挤占任务描述、代码和相关文档的空间——导致智能体要么忽略关键约束，要么优化了错误的目标。
过多的指导等于没有指导。 当一切都“重要”时，就没什么是重要的了。智能体最终会陷入局部模式匹配，而不是有意识地进行全局导航。
文档即刻腐烂。 单体式的说明书会变成过时规则的坟场。智能体分不清什么是对的，人类不再维护，文件就变成了一个诱人的麻烦。
难以验证。 一个巨大的文本块难以进行机械化检查（如覆盖率、新鲜度、所有权、交叉链接），因此偏离现实在所难免。

因此，我们不把 AGENTS.md 当作百科全书，而是把它当作目录 。