Skip to content

规划文档深度归档治理

本文档负责定义 roadmap.mdtodo.mdtodo-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. 阶段归档流程

  1. 确认当前阶段全部任务已完成
  2. 将已完成任务从 todo.md 移入 todo-archive.md
  3. 更新 roadmap.md 中对应里程碑状态
  4. 若触发行数阈值,按阶段区间切分归档分片
  5. 更新 archive/index.md 索引

4. 当前基线

  • roadmap.md: 健康窗口。
  • todo.md: 健康窗口。
  • todo-archive.md: 健康窗口(M0 一期)。

Released under the MIT License.