Files
Arcrun/system-dev/docs/5-records/incidents
uncle6me-web 5d00e71275 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>
2026-07-03 07:13:33 +08:00
..

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)會踩同樣假設的最好預防。