# 為什麼需要這個模板

## CC 是個優秀的工程師，但不是個好的專案經理

Claude Code 執行力強、速度快。小專案裡這是優點，大專案裡變成問題：

**問題一：改這個壞那個**
CC 沒有全局觀。它在每個 session 裡從零開始，不知道上次做了什麼、哪些東西不能動、
為什麼做了這個決定。結果就是：修了 A，壞了 B，下次又把 B 修回來，再壞了 A。

**問題二：文件越來越亂，記憶不可靠**
隨著開發，對話裡累積了大量決策、踩坑記錄、架構說明。但這些知識：
- 存在對話歷史裡，新 session 全部消失
- 就算寫成文件，散落在根目錄、各種 md 裡，CC 找不到
- 即使找到了，是給人看的語言，不是給 LLM 的格式

最後的結果：**你變成那個唯一的記憶**。你要重複解釋同樣的事，
CC 要重複犯同樣的錯。

---

## 兩套系統，解決兩個問題

### SDD 系統：給 CC 全局觀

靈感來自 Kiro 的做法。核心原則只有一條：**動手前必須有設計文件**。

```
使用者提需求
    ↓
CC 找對應 SDD（docs/3-specs/[子系統]/design.md）
    ↓
找到 → 讀 design.md + tasks.md，宣告範圍再動手
找不到 → 停手問使用者，不自行猜測
```

SDD 強制 CC 在動手前先思考：這個修改影響哪些地方？有沒有超出範圍？
有沒有違反既定的技術限制？

### LLM Wiki：給 CC 可累積的記憶

靈感來自 Andrej Karpathy 的 LLM Wiki 概念——不用 embedding，
只靠 pre-compile 把知識整理成 LLM 友善的格式。

**雙空間設計：**
- `docs/`：人寫的原始文件，依照開發生命週期分類
- `.claude/wiki/`：CC 整理的 LLM 友善知識，每次 session 累積

每次 session 開始，CC 讀 wiki，不需要重新學習。
每次 session 結束，CC 更新 wiki，知識不再消失。

---

## 設計原則

**疊加，不覆蓋**
接入已有專案時，現有的規範、文件、CLAUDE.md 全部保留，
新系統疊加上去，不破壞已有的東西。

**結構即協議**
固定的目錄結構讓 CC 和你共用同一套分類規則。
你把任何文件丟進來，CC 知道要收到哪裡。

**CLAUDE.md 不增長**
CLAUDE.md 是導航牌，不是內容倉庫。超過 100 行就是架構出問題，
不是加更多內容的信號。

**對話結論必須 capture**
最重要的知識往往在對話裡，不在文件裡。
`/wiki-capture` 解決這個問題：討論完當場存，知識不再隨對話消失。