# 规划文档导航

## 使用原则

`plans/` 目录保存架构设计、实施计划、专题方案和历史问题分析。

不要把所有 plan 都当成当前权威事实。
当前事实优先级应是：

1. `README.md`
2. `docs/README.md`
3. `docs/openclaw/README.md`
4. `docs/openclaw/openclaw-handoff.md`
5. `docs/openclaw/openclaw-orchestration-flow.md`
6. `TODO.md`

`plans/` 更适合回答：

- 为什么这样设计
- 某个能力是怎么分阶段落地的
- 某次事故当时是怎么分析的

## 当前权威规划

这些文档仍然是当前协作时应优先阅读的规划基线：

- `reader-mcp-architecture-design.md`
  - MCP workflow service 的总体架构方向
- `reader-mcp-implementation-plan.md`
  - 实施分阶段计划
- `../TODO.md`
  - 当前任务状态与落地进展

## 已完成能力的专题方案

这些方案主要用于回看设计取舍，相关能力已经基本落地：

- `freshrss-pipeline-async-job-plan.md`
  - 主日报 async job 方案
- `article-summary-async-job-plan.md`
  - 单篇总结 async job 方案
- `resume-run-minimal-design.md`
  - `resume_run` 最小恢复语义设计

## 仍有参考价值的专题设计

- `keyword-cleanup-artifact-slimming-v1.md`
- `keyword-cleanup-review-suggestions-layer-design.md`
- `article-summary-prompt-independent.md`
- `article-deep-summary-skill.md`
- `docker-deployment-plan.md`

## 历史问题分析

- `issues/2026-04-06-reader-digest-sigterm.md`
  - 一次真实运行事故的分析

## 建议阅读顺序

如果是新接手维护：

1. `reader-mcp-architecture-design.md`
2. `reader-mcp-implementation-plan.md`
3. `../TODO.md`
4. `../docs/openclaw/README.md`
5. `../docs/openclaw/openclaw-handoff.md`

如果是在排查某一类能力：

- 主日报启动/轮询：看 `freshrss-pipeline-async-job-plan.md`
- 恢复：看 `resume-run-minimal-design.md`
- 单篇总结：看 `article-summary-async-job-plan.md`
- 历史故障：看 `issues/2026-04-06-reader-digest-sigterm.md`