Arcrun/system-dev/wiki/TAXONOMY.md

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. 新增子系統軸要慎：子系統是檢索骨架，動它影響全庫聚類；形態軸（呈現形式）擴充較安全。不確定就先用現有最接近的，並在卡片或本檔註記「待人類複核此分類」。