主题
活跃计划区
这里放还没做完的一次性 plan / handoff,以及少数常驻的清单文件。 做完了就移进 archive/(见那边 README 的「归档节律」)。
先看哪份
| 你想知道 | 去处 |
|---|---|
| 接下来做什么、按什么优先级 | product-iteration-roadmap-2026h2.md |
| 零散任务池、"以后再说"的想法 | backlog.md |
| 上架 / 发行 / 运营基建 | product-launch-todo.md |
| 做过什么、怎么做的 | ../../CHANGELOG.md(桌面端 + admin + supabase + 工程);移动端在 ../../rvh/CHANGELOG.md |
| 某功能为什么这么设计 | 先 grep archive/ |
常驻文件(永不归档,持续追加):backlog.md · product-iteration-roadmap-2026h2.md · product-launch-todo.md · project-refactoring-plan.md · phrase-eval-log.md · cross-end-sync-evolution-roadmap.md · llm-product-upgrade-roadmap.md。其余都是一次性的,有终点。
常驻 ≠ 只增不减。
backlog.md的## ✅条目攒够一批移进backlog-archive.md(保留裁决推理,不删)。📦 2026-08-30 那次分片给这条节律加了两款(T4-3 实测得出): ① 不只搬
## ✅—— 已结案但体量极大的留痕(外部建议的逐条裁定、多轮 as-built 流水) 同样该进归档区,它们的价值(防止同一批建议被反复评估)在那边一样成立。 ② 长成 plan 形状的条目要外迁成 plan,别留在 backlog 里长到 24 KB (判据:有阶段编号 + gate 判据 + 跨端接力顺序 —— 那已经不是「零散任务池」了)。🔀 跨端条目落点 = 「谁执行谁持有」:正文只存一份,落在将来真正动手那一端的 backlog, 另一端只留指针;两端都要动的(契约类)落根侧。规则本体写在两份 backlog 的头部。
🚫 红线不许只写在这里
一次性 plan 会归档,红线不会——一旦归档,那条约束就从活跃视野消失,而代码还在依赖它。 发现新不变量时,先写进稳定归属(桌面端 → CLAUDE.md §4 / admin → admin/CLAUDE.md §3 / UI → ../ui-standards.md / schema → ../database-schema.md §10),plan 里只留指针。 归属总表见 CLAUDE.md §4「红线归属规则」,守门 = /arch-check S28。
实例:admin 的「
force-dynamic是 nonce-CSP 硬前提不是性能取舍」曾只写在admin-hardening-plan.md里,而admin/CLAUDE.md反而把它描述成性能措施—— 照控制文件读会把它当可选优化摘掉,摘掉即白屏且 HTTP 仍 200。2026-08-15 已修正。
🔒 每份 plan 必须有状态行
紧跟标题写,格式随意但必须能一眼判断做没做完:
markdown
> 物理仓库:`/Users/larry/reading-browser`(RB 桌面端)
> 创建:2026-08-14 · 状态:**✅ T1-T7 全部完成(2026-08-14)**;T8 转交 backlog §2.2没有状态行的 plan 无法分诊——不读完全文加对代码,谁也不知道它还算不算待办。 2026-08-14 治理时活跃区有 8 份处于这种状态,只能逐份人肉核。 归档批次记录里那三份"说反话"的状态行(写着"待执行"而事实早已完成)也是同一个病的另一面: 状态行只在创建时写一次、之后不维护,比没有更坏。
⚠️ 别照着 plan 末尾的"文档更新清单"回填 CLAUDE.md
许多 plan 收尾项写着「CLAUDE.md §2 关键文件索引补 3 个组件」「CLAUDE.md §5 迁移表加 v23 行」。 这两处已于 2026-08-14 撤销:§2 的 44 行文件清单(34 行只是把文件名换成中文复述)与 §5 的迁移表 (与 database-schema.md §10 重复)都已删除,两者当时都已腐烂到指向不存在的文件 / 漏记版本。 照着执行 = 把烂账重新种回去。
现在的去处:
| 旧收尾项写的 | 实际该去 |
|---|---|
| CLAUDE.md §5 迁移表 | ../database-schema.md §10(唯一真相源) |
| CLAUDE.md §2 关键文件索引 / Rust commands 列表 / Zustand stores 列表 | 不记 —— 用 ls / Grep / commands/mod.rs |
| CLAUDE.md §2 UI 组件表 | ../ui-component-inventory.md |
| 新踩的坑、新的"唯一入口"裁定 | CLAUDE.md §2「非显然约定索引」(判据见该节开头) |
权威清单以 /doc-sync-check skill 为准。