用途:把一份已完成的 deep-plan 计划文档中的已验证知识,迁移到未来智能体会实际加载的三份文件中,避免计划文档随实现推进而过期失效。目标文件及用途:AGENTS.md 存放智能体操作规则与仓库的已验证事实;docs/ARCHITECTURE.md 存放组件图、数据流与框架机制并附引用;ROADMAP.md 存放分阶段路线图及当前阶段状态。
核心原则:只摄入已验证知识,过期证据需重新验证或丢弃;计划中标记为 UNVERIFIED 的断言不得进入 AGENTS.md 或 docs/ARCHITECTURE.md,只能在 ROADMAP.md 中作为明确的开放问题出现;CORRECTED 条目优先于其纠正的原始错误;引用必须随断言一起复制,丢失 file:line、厂商路径或文档 URL 的事实视为未摄入。
使用方式:按六步执行——定位计划并确认目标;做过期检查,用 git log --oneline <plan-file-mtime-or-date>..HEAD 列出计划之后的提交,对引用文件出现在这些提交中的断言重新打开文件验证;分别写入 AGENTS.md、docs/ARCHITECTURE.md、ROADMAP.md,按 references 中的模板结构执行,已存在则逐节合并、不覆盖人工撰写的部分;最后报告写入、更新、跳过与因过期丢弃的内容。若仓库已使用 CLAUDE.md 或 AGENT.md 作为智能体指令文件,则合并进该文件,不新建并行的 AGENTS.md。
限制与检查:AGENTS.md 每次会话都会加载,硬性预算为 150 行以内,超出需删减;三份文件之间不得重复,规则、结构、排序分别归属不同文件,用交叉链接代替复制;仓库元数据必须与 git remote -v / git config 输出完全一致,不得凭仓库名构造托管 URL,无远程则如实说明。资料未提供具体安装命令、收费方式或平台支持信息。