ADR-NNNN: <決策的簡短標題>

• Status: Proposed | Accepted | Superseded by ADR-YYYY | Deprecated
• Date: YYYY-MM-DD
• PR / Commit: #NNN（必填，指回實作；可多筆）
• 相關: ADR-XXXX、issue #NNN、docs/XXX_SPEC.md（選填）

Context

當初的處境與限制：要解決什麼問題、有哪些約束（資料來源、效能、相容性、時程）、 為什麼現在要做。把「不做會怎樣」也寫進來。

Decision

實際做了什麼（不是計畫想做什麼）。關鍵實作選擇、用了哪個演算法 / 資料流 / schema。若評估過其他方案，列出來並說明為何沒選。

Consequences

這個決策帶來什麼：

• 正面：解決了什麼、量化的話更好（效能數字、覆蓋率）。
• 代價 / trade-off：刻意接受了什麼限制。
• 後續：留下哪些 follow-up（附 issue 號）、什麼條件下需要重新檢視這個決策。