# system-dev/wiki/ — LLM 記憶系統

> 新 session 開始時從這裡導航。
> 目的：讓 CC 不需要重新學習已知的事。
> 維護者：CC（人不手動編輯這裡）

---

## push 檔（session 開始由 hook 主動注入，CC 行動前必看見）

| 檔案 | 注入形態 | 內容 |
|------|---------|------|
| `status.md` | 全文 | 當前進度、下一步（時態狀態）|
| `principles.md` | 全文（一行一條）| 跨全局設計原則，行動前必服從 |
| `mistakes.md` | 標題+一行症狀，全文按需展開 | 踩過的坑、被糾正的誤解（防不自覺盲區）|

> 為什麼這三個 push 而非 pull：它們是「CC 不會主動查、但不看就出事」的盲區。詳見 `/wiki-init` 的「push vs pull」。

---

## pull：cards/（CC 按需檢索）

一切知識內容——原文摘要、AI 筆記、決策、概念知識——都寫成 `cards/<bucket>/` 的概念原子卡。
`decisions-summary.md` 已降級為 cards（決策＝知識內容）；既有的保留為相容。

---

## 維護規則

1. 只增不刪——記錄 append，內容改了加新條目說明「舊的已更新」
2. status.md 每次 session 結束更新；mistakes/principles 一發現就 append
3. principles 一行一條、≤15 條（超過代表該合併或下放成 card）
4. **新增一個檢索角度 = 在下方「多角度視圖」加一節，不開新實體檔、不問用戶**

---

## 多角度視圖（由 /wiki-init、/wiki-capture 填入）

INDEX 是**所有檢索角度的入口**，不只標籤。原文是唯讀 SSoT，wiki 是改寫過的記憶。
新增角度只要在這裡加一節（如「決策角度」「原則角度」），指向對應 cards 或 push 檔——**不必新增實體特殊檔**。

### 子系統角度（按 `TAXONOMY.md` 的軸聚類，指向桶子索引）

#### 架構決策（跨子系統）
- [[decisions/00-INDEX]] — arcrun 架構決策（13 卡，已從 decisions-summary 全量改寫成原子卡）

> 子系統卡桶（零件架構 / cypher / credential / recipe / kbdb / 薄殼 / 部署）尚未獨立建——
> 決策卡已用 frontmatter `tags:` 掛子系統軸，可從 INDEX 標籤過濾；純子系統知識卡由 /wiki-capture 依需開桶。

### 決策角度（取代舊 decisions-summary.md 的視圖）

> `decisions-summary.md`（全文）保留為相容；13 條決策已逐條改寫成 `cards/decisions/` 原子卡，入口見 [[decisions/00-INDEX]]。
> 按子系統分群的清單在桶子索引內，這裡只放跨子系統最常查的：

- [[工作流是default零件是例外]] — 自用→工作流，全生態重用→才零件（mindset §1）
- [[薄殼原則-能力長在API]] — 能力只實作一次放 API，介面全薄殼（rule 07）
- [[自力救濟階梯-缺能力怎麼補]] — 缺能力分流：自家補API／第三方 workflow 補丁（issue #4）
- [[service-binding-vs-cypher-binding]] — 零件串接走 HTTP URL，禁 service binding（rule 03）

> 結構：INDEX（多角度入口）→ `cards/<bucket>/00-INDEX.md`（桶子索引，固定名）→ 概念原子卡。
> 指 `00-INDEX` **一律帶路徑** `[[bucket/00-INDEX]]`（固定名跨桶撞名）；卡片間用裸 `[[卡名]]`。
> 分類由卡片 frontmatter `tags:` 承載，標籤字典見 `TAXONOMY.md`。詳見 `/wiki-init` 規範。
