docs(wiki): session 末更新 status + 補兩條 mistakes

- status.md:T0.5–T5 實作完成、PR #3/#4 拆分、issue #2 close、下次 merge 順序 + 部署待驗
- mistakes.md:① 功能 PR 別混 template 遷移(拆 PR)② 跨 repo 契約漂移先查總管裁定別自決

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-26 20:55:13 +08:00
parent 06e901f590
commit 5d762440b7
2 changed files with 24 additions and 12 deletions
+10 -7
View File
@@ -15,11 +15,14 @@
## 誤解記錄
(初始化時為空,隨專案進行 append
⚠️ MISTAKE: 功能 PR 混進 template 1.9.x 知識庫遷移(system-dev/ + .claude/
症狀: 開功能分支時順手把 wiki-init / template 遷移的 system-dev/、.claude/ 一起 commit 進同一筆,PR 同時含「功能改動」+「基建遷移」。
正確做法: 功能與基建分兩個 PR。功能 PR 只留 src/tests/contracts/config/SDD-taskstemplate 遷移(system-dev/ + .claude/ + SDD 位置搬移)獨立成筆、本 repo 自行 merge。從乾淨分支重建:reset 回 main → 只 stage 核心 → force-with-lease 蓋功能 PR;遷移另開分支。
原因: ① 淹沒真正改動、審查難 ② 多 repo 同跑 1.9.x 遷移會撞衝突(graph 撞過)③ 可能夾私稿。system-dev/ 該進 git,但走自己一筆、不混功能、別 gitignore 它。
日期: 2026-06-26
格式:
⚠️ MISTAKE: [錯誤描述,一句話]
症狀: [CC 通常怎麼表現這個錯]
正確做法: [應該怎麼做]
原因: [為什麼會錯]
日期: [YYYY-MM-DD]
⚠️ MISTAKE: 抓到跨 repo 契約漂移時自己拍板對齊方向
症狀: 發現 graph 部署端 .strict() Zod 比凍結 contract 窄(會 422 新欄位)→ 想直接決定 ingest 該送哪個版本。
正確做法: 契約是雙邊事 → 先查總管在相關 issue 的裁定(graph#1 已裁「contract 是 SSoT、實作追它、graph receiver 補對齊、ingest 不退」),照裁定做、別自決。跨 repo 修正要先問人。
原因: contract 是凍結單一真相源(三守則);單邊擅自退讓或改 contract 會破壞雙邊共識。見 [[envelope-契約]]。
日期: 2026-06-26