规划文档深度归档治理
本文档负责定义 roadmap.md、todo.md 与 todo-archive.md 的深度归档管理规则。
1. 阈值定义
todo.md
- 健康窗口:
<= 500行。 - warning 触发:
501 - 600行。 - 强制分片:
> 600行。
roadmap.md
- 健康窗口:
<= 800行。 - warning 触发:
801 - 900行。 - 强制分片:
> 900行。
todo-archive.md
- 健康窗口:
<= 500行。 - warning 触发:
501 - 700行。 - 强制分片:
> 700行。
2. 主窗口保留策略
roadmap.md:保留当前阶段规划、最近阶段的审计归档摘要。更早阶段迁移到archive/roadmap-phases-*.md分片。todo-archive.md:保留最近3 - 5个已归档阶段的完整块。更早阶段迁移到archive/todo-archive-phases-*.md分片。
3. 阶段归档流程
- 确认当前阶段全部任务已完成
- 将已完成任务从
todo.md移入todo-archive.md - 更新
roadmap.md中对应里程碑状态 - 若触发行数阈值,按阶段区间切分归档分片
- 更新
archive/index.md索引
4. 当前基线
roadmap.md: 健康窗口。todo.md: 健康窗口。todo-archive.md: 健康窗口(M0 一期)。