AI Agent开发文档管理指南

文章提出把文档放在仓库内并与代码一起版本管理，按有效期分层：根目录及模块级CLAUDE.md保持100至200行以内的常驻规则；docs/features/存放需求与验收标准；docs/adr/记录决策及替代关系；任务计划在完成后废弃；运维文档按事件更新。需求变更时先改规格再改实现，并用REQ-ORDER-CANCEL-001这类ID贯穿规格、测试名和提交信息，便于让Agent定位受影响代码；代码与文档更新放在同一PR，过时文档应删除而非保留。

AI推荐理由 文章系统给出面向AI编码Agent的仓库文档分层管理方法：按有效期划分CLAUDE.md、docs/features、ADR、任务计划和运维文档，并强调需求ID追踪、用新ADR替代旧决策、代码与文档同PR更新等；对使用Agent开发的团队有实操价值，但属经验性指南，无量化验证。