put-plan-runbook-docs-under-docs-plan.md

August 14, 2026 · View on GitHub

后续在 knowledge-pipeline 仓库新增计划、spec、PRD、执行计划、里程碑、runbook、goal 验收或阶段执行包时,默认放入 docs/plan/,并更新 docs/plan/README.md 与必要的上游索引。

docs/todolist/ 只保留待办、审计、复核和阶段状态入口;需要引用计划或 runbook 时链接到 docs/plan/。docs/operations/ 只承接已经沉淀为长期稳定人工操作手册的内容。

Why: 计划/runbook 文档如果散落在 docs/todolist/、docs/operations/ 和其它目录,会让执行入口和状态入口混在一起,后续 agent 容易错把待办清单当完整 runbook,或把阶段计划当长期操作手册。

How to apply: 新建 plan/runbook 前先检查 docs/plan/README.md;若是阶段执行包,放 docs/plan/。若后续变成稳定操作手册,再迁移或复制到 docs/operations/ 并说明权威入口。