chore: D22 落地——docs/SDD/wiki/CLAUDE.md 進 repo(Gitea private 預設全 push)

頂層 D22 決策(leo 2026-07-03 拍板):推什麼由開發環境歸屬決定,
Gitea private=除機敏值/build 產物/.github 外全 push。
解 T1.5 卡點:雲端工人 clone 拿得到 credential-store-migration.md,可就地改寫 SDD。
機敏掃描兩輪通過(新增 189 檔約 2.1MB,node_modules/dist/wasm 照舊排除)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
uncle6me-web
2026-07-03 07:13:15 +08:00
parent c830150da1
commit 5d00e71275
190 changed files with 39486 additions and 14 deletions
@@ -0,0 +1,33 @@
# Incidents
平台/架構級事件 post-mortem。每份檔案 = 一個事件。
不同於 SDD`.agents/specs/`)的「我們要怎麼設計」,incident 記錄「我們實際撞過什麼雷、怎麼診斷、怎麼修、未來怎麼避免」。
## 命名慣例
`YYYY-MM-DD-{short-slug}.md`
例:`2026-05-13-cypher-outbound-522.md`
## 寫的時機
- 花了顯著時間(> 1 小時)才查清根因的問題
- 平台層 / CF / 架構層問題(不是普通 code bug)
- 需要修架構決策或 URL 慣例的問題
- 「以為解決了結果不是」的反覆事件
普通 bug fix 不需要寫 incident。
## 檔案結構建議
每份 incident 至少含:
- **症狀**:怎麼觀察到的
- **誤判路徑**:走過哪些錯方向(含為什麼錯)
- **真相**:根因
- **修法**:實際改了什麼
- **驗證**:怎麼確認解了
- **未來避免**:下次怎麼提早識別
最重要的是**誤判路徑**——這是未來自己(或其他 dev)會踩同樣假設的最好預防。