# TAXONOMY.md — 標籤字典（arcrun repo 專屬）

> wiki 卡片的 frontmatter `tags:` **只能用這裡列出的標籤**。
> 這不是凍結——字典**可以擴充**，只是**禁止繞過字典在卡片裡直接冒新標籤**。
> 維護者：CC（由 /wiki-init 初始化、隨 wiki 演進受控擴充）。
>
> **遇到現有軸都裝不下的內容時，照這個流程（先查、後擴、登記）**：
> 1. **先查既有**：現有標籤真的都不合，還是只是同義詞？（`零件` vs `component` vs `WASM零件` 是同一軸，別重造）
> 2. **確實是新軸** → 把新標籤加進本檔（附一句定義），再用。不必停下來問人，但「先登記再使用」這道查核不能省。
> 3. 自由增生才是要防的——同義標籤散開會讓同類卡片分散、下游聚類失準。受控擴充（先查重、再登記）不會。
>
> **字典是每個 repo 各自的**：arcrun 是開發 repo，軸是「子系統／層級／決策類型」，與知識型 vault 的「知識管理／學習認知」本來就不同。

---

## 分類採雙軸（一張卡可多重歸屬）

分類由 **frontmatter `tags:`** 承載，不靠資料夾、不靠行內 `#tag`。
一張卡同時掛「子系統 1-3 個 + 形態 0-2 個」，可從任一軸過濾。

### 子系統 / 領域（主軸，每卡 1-3 個）

> arcrun 的架構分層。卡講「哪一塊」就掛對應標籤。

- `零件架構` — WASM 零件、component worker、registry、部署模式
- `cypher` — cypher-executor、workflow 執行、host functions、graph executor
- `credential` — auth primitive、加解密、JWT、recipe auth、credential 注入
- `recipe` — recipe schema、UUID 市場模型、投稿、信任機制
- `kbdb` — KBDB 資料層、三表、proxy、租戶隔離、embedding/vectorize
- `薄殼` — CLI / MCP / SDK 介面層、能力下沉 API、帳號統一
- `部署` — wrangler、local-deploy、self-hosted、CI 邊界、account override
- `平台原則` — 跨子系統的世界觀（工作流 vs 零件、誠實不假綠、AI→工具）

### 形態（副軸，每卡 0-2 個）

- `架構決策` — 一次性的設計選擇 + trade-off（取代舊 decisions-summary 視圖）
- `踩坑` — 事件復盤、被糾正的誤解（與 mistakes.md 互補：mistakes 是 push 摘要，card 是全文）
- `機制說明` — 某個能力「怎麼運作」的自包含解釋
- `禁令` — hook 強制的硬規則背後的 why
- `案例經驗` — 壓測、dogfood、實證落地的具體記錄

---

## 規則

1. **先查重、再登記、才使用**：禁止繞過字典在卡片直接冒新標籤；新標籤先確認非現有同義詞，加進本檔（附定義）再用。
2. **子系統 vs 形態分開**：子系統是「講哪一塊」，形態是「以什麼形式呈現」，不要混。
3. **頂層 INDEX.md 的標籤視圖依本字典的軸聚類**——字典改了，INDEX 視圖跟著更新。
4. **新增子系統軸要慎**：子系統是檢索骨架，動它影響全庫聚類；形態軸（呈現形式）擴充較安全。不確定就先用現有最接近的，並在卡片或本檔註記「待人類複核此分類」。