Skip to content

活跃计划区

这里放还没做完的一次性 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 为准。