ADR-lite 格式
每個決策都遵循精簡的結構：
| 區塊 | 說明 |
|---|---|
| 上下文 | 為什麼需要這個決策 |
| 決策 | 決定了什麼 |
| 為什麼 | 單一最有力的理由 |
| 而非 | 考慮過的備選方案（最多 3 個） |
| 代表 | 後果與受影響的範圍 |
對複雜的決策，延伸格式會加上 取捨 區塊。
智慧功能
自動推斷備選方案
如果你只說了決策，AI 會推斷 1-2 個常見備選方案：
/note-decide user service 用 PostgreSQLAI 會補上：而非 MongoDB、MySQL — 因為這些是資料庫選型的常見備選方案。
決策鏈
系統會搜尋現有的決策筆記。如果你的新決策取代了舊的，就會建立 「Supersedes」 連結：
Supersedes：「user service 用 MongoDB」（2 月 10 日）這會建立一段你可以回溯的決策歷史。
重複偵測
在建立新筆記之前，/note-decide 會搜尋相關的先前決策，如果已有類似的決策就提醒你。
標題準則
好的標題是可執行且具體的：
- 「auth 用 JWT」（而非「驗證」）
- 「部署到 Fly.io」（而非「部署」）
- 「從 REST 換成 GraphQL」（而非「API」）
何時用 /note-decide
當你想記錄你為什麼選某個方案，而不只是選了什麼的時候用它。決策記錄在這些時候格外珍貴：
- 新成員問「我們當初為什麼這樣做？」
- 你需要在幾個月後重新檢視某個決策
- 你想追蹤架構是怎麼演進的