cleanuplisted

# Knowledge Cleanup `cleanup` 是知识和工件的收尾闸门。它对齐 docs、代码、生成物和 selected recovery surface，防止项目知识腐化。它不是重构许可证，也不是单独的暂停/恢复 lane。 ## 路由快照 - **Use when**: 一个 batch 需要知识、文档、生成物、恢复面或交接收尾。 - **Do not use when**: ready claim 还没验证、失败未解释、或需要改行为。 - **Route to**: 知识对齐后 done；缺行为或测试转 `implement`；不明失败转 `diagnose`；工作面缺口转 `harness-builder`。 ## 目的 - 保持 `AGENTS.md` 是薄规则手册，不写 changelog、临时状态或会话叙事。 - 确保 README、docs、generated artifacts 和验证命令描述当前真实项目。 - 检查 recovery surface 是否漂移、膨胀或与 git diff 矛盾。 - 把未解决的 doc drift 和 residual risk 记录成明确 follow-up。 ## 何时使用 ### 触发信号 - `verify` 已通过，slice 可以关闭。 - Review 发现文档漂移、知识腐化或低风险 residue。 - 用户说「收尾」「整理」「同步文档」「把状态弄干净」。 - 当前 artifacts 不再真实描述代码、命令、证据或 blockers。 - 需要交接卫生，但不应该保留单独交接 lane。 ### 不要使用 - Verification 尚未运行且 ready claim 需要证据：用 `verify`。 - 有未解释失败：用 `diagnose`。 - Cleanup 需要行为变化：回 `plan` 或 `implement`。 - 用户要求继续实现，而不是 closure。 ### 路由规则 | 状态 | 下一步 | | --- | --- | | 文档和 artifacts 已对齐 | done | | 发现缺失行为或测试 | `implement` | | 发现失败或不明根因 | `diagnose` | | 发现 plan/scope 漂移 | `plan` | | 发现项目级 recovery surface 缺口 | `harness-builder` | ## 先读取这些输入 1. `AGENTS.md`、README、docs 目录和相关 generated artifacts。 2. selected recovery surface：phase、blocker、next、evidence、risks、deferred cleanup。 3. `git status --short` and `git diff --stat`。 4. 生成物来源脚本，例如 flow HTML 只能由 generator 更新。 5. 本 batch 创建的 temp files、logs、screenshots、local reports。 Never delete or rewrite uncertain files. Ask or defer. ## Knowledge Freshness Check - README commands match real commands. - `AGENTS.md` remains a