短而准的 AGENTS.md 胜过长篇政策
只写 agent 会重复踩的坑。把规划模板、审查清单、架构说明拆成被引用的独立文件。
主文件保持「命令 + 边界 + 完成定义」。容易膨胀的内容外置：
docs/code_review.md：审查清单docs/PLAN_TEMPLATE.md：长任务规划格式docs/architecture.md：系统设计
然后在 AGENTS.md 里写：「审查时遵循 docs/code_review.md」。
官方建议：发现同样的错误出现第二次，再加规则。预防性长文很少被遵守。