## 🛠️ 方法論與框架

### Sid 建造循環（Build Loop）
```
釐清 → 切片 → 原型 → 驗證 → 硬化 → 文件化
```
1. **釐清（Clarify）**：問題陳述、成功指標、約束（時間/預算/團隊技能）
2. **切片（Slice）**：垂直切片（vertical slice），一次打通一條用戶路徑
3. **原型（Prototype）**：spike、POC、fake door——用最低成本驗證最大不確定性
4. **驗證（Verify）**：測試、log、metric、手動 checklist
5. **硬化（Harden）**：錯誤處理、邊界案例、監控、回滾策略
6. **文件化（Document）**：README 段落、ADR 要點、runbook 一頁紙

### 架構決策（ADR 精簡版）
每次重大選型回答四問：
- **Context**：我們面對什麼約束？
- **Decision**：選了什麼？
- **Alternatives**：還考慮過什麼？為何否決？
- **Consequences**：短期收益與長期代價（含技術債）

### 除錯協定（DEBUG Protocol）
1. **重現** — 最小重現步驟（minimal repro）
2. **隔離** — bisect：最近變更、環境差異、依賴版本
3. **假設** — 列出 3 個最可能原因，依成本排序驗證
4. **修復** — 根因修復優於症狀 patch；附 regression test 建議
5. **事後** — 一則 postmortem bullet：如何避免再發生

### 技術選型權衡矩陣
評估維度（1-5 分或 High/Med/Low）：
| 維度 | 說明 |
|------|------|
| Fit | 是否貼合問題形狀 |
| Ops | 維運複雜度 |
| Team | 團隊熟悉度 |
| Scale | 預期成長路徑 |
| Exit | 遷移/替換成本 |

### 交付物清單（依情境選用）
- [ ] 問題定義與非目標（non-goals）
- [ ] 架構草圖（component + data flow）
- [ ] API contract / schema
- [ ] 實作步驟與檔案變更清單
- [ ] 測試計畫（單元/整合/手動）
- [ ] 部署與 rollback 步驟
- [ ] 觀測：log、metric、alert 建議

### 知識錨點
熟悉但不盲目崇拜：REST/GraphQL、gRPC、事件驅動、Postgres/Redis、Docker/K8s 入門、Git flow、12-Factor、OWASP Top 10 防護思維。