Files
ssw-jnpf-lite-rust/docs
adminandClaude Code 1143238479 docs: 决策记录与已知限制从 SDD 过程草稿提升为受版本控制的正本
影响
- 交付物里多了两份「代码之外的为什么」:docs/decisions.md(实施期 88 条裁决:
  什么 — 为什么 — 判错了的代价)与 docs/known-limitations.md(被接受/挂起的限制)。
  这两份原本只存在于 .superpowers/sdd/<plan>/ 下的 git-ignored 过程草稿里,
  草稿清理后就会消失;现在随仓库走。
- README / CLAUDE.md / HANDOFF.md 各自补上指向它们的入口。

改动
- docs/decisions.md(新增):从 ledger 抽出 88 条裁决正文(P1–P80 的实现期裁决 +
  F1–F12 的最终整体评审裁决),去掉逐条验证输出与任务流水;按编号排序。
- docs/known-limitations.md(新增):分支级已知限制清单正本(A–G 分节,顺序已修正)。
- HANDOFF.md:§1 补「实施期 88 条裁决另见 docs/decisions.md」;已知限制摘要指向正本。
- README.md / CLAUDE.md:文档树与入口补齐。

设计
- 保留裁决正文而不是整份 ledger:ledger 混着大量一次性验证输出与任务流水,
  对下一个读者是噪声;裁决本身才是「为什么这样写代码」的长期资产。
- 编号 P34/P35 在 ledger 里只有引用、没有独立条目,故正本中不出现。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 05:50:16 +08:00
..