feat(daemon-beta t2): template 代裝——embed v1.18.0 快照(36檔)/冪等不覆寫/daemon 啟動自動鋪/template-install 子命令；scan 加 SkipDirNames 防 system-dev 與 CLAUDE.md 被當知識掃

- 測試 3 支新增全綠（首鋪/冪等護用戶檔/掃描跳 template 產物——第三支先紅抓到 CLAUDE.md 洩入再修綠）
- CLI 實跑：新鋪 36 檔→重跑 0 新檔（冪等證據）

templatefs/.claude/VERSION

@@ -0,0 +1 @@
+1.18.0

templatefs/.claude/commands/issue-handle.md

@@ -0,0 +1,80 @@
+---
+description: 處理本 repo 的 GitHub issue（讀/回/結案），跨 repo 發要先問人
+---
+
+# /issue-handle — GitHub issue 處理指引
+
+你（CC）可以、也該主動用內建的 `gh` CLI 讀寫**自己 repo** 的 GitHub issue。
+很多人不知道這件事——`gh` 已內建認證，零開發、零外部依賴。issue 同源於 repo，
+比 Notion / Sheets 更適合做交辦與待辦，不必引入外部 SaaS。
+
+這份指引分四層，界線要守住。
+
+---
+
+## 1. 讀 / 回 / 結案（普世基本功 — 直接做，不用問）
+
+對**自己這個 repo**，主動處理 open issue：
+
+```bash
+gh issue list --state open          # 看有哪些待辦
+gh issue view <n>                   # 讀完整內容
+# …實作…
+gh issue comment <n> --body "[<本 repo> CC] 做了什麼、怎麼決定的、改了哪些檔"
+gh issue close <n>                  # 確認解決後結案
+```
+
+回覆要有料：說清楚**做了什麼、為什麼這樣決定、動了哪些檔**，而不是只回「done」。
+issue 作者（可能是另一個 repo 的 CC，或人類）要靠你的回覆判斷對不對。
+跨 repo 的 issue/comment 開頭一律署名 `[<本 repo> CC]`（見第 3 節鐵律）。
+
+---
+
+## 2. 發 issue 給「別的 repo」（要先問人 — 不可擅自）
+
+當你發現**別的 repo** 有值得修正的地方時：
+
+> ❌ 不要擅自 `gh issue create -R other/repo …`
+> ✅ 先問人類：「我發現 X repo 有 Y 問題，要我幫你去那邊發 issue 嗎？」得到同意才發。
+
+理由：通用 template 不知道使用者對那個 repo 有沒有權限、想不想發。留一道人類確認最安全。
+（對**自己 repo** 開 issue 記待辦則可直接做——那是自己的 repo。）
+
+---
+
+## 3. 跨 repo 署名（鐵律 — 絕不可漏）
+
+所有 repo（mira / graph-plugin / ingest-plugin / Arcrun / template…）共用**同一個 GitHub 帳號**發 issue/comment，
+所以 issue/comment 的 author **全顯示同一個帳號、看不出是哪個 repo 的 CC 發的**。
+
+> **跨 repo 的 issue/comment 一律在開頭署名 `[<本 repo> CC]`**，靠內容署名溯源。
+
+- 收件方 CC 回報：`[graph-plugin CC]` / `[mira CC]` / `[ingest CC]` / `[arcrun CC]`…
+- 總管下令/追問：`[InkStoneCo 總管]`
+- 署名放 comment **第一行或標題式開頭**（既有的「## 回報（graph CC）」即合格）。
+
+為什麼只能這樣：GitHub issue/comment 的 author = 發送帳號，**沒有 per-repo 身份這設定**；
+`git config user.name` 只影響 commit 作者、不影響 issue/comment author；
+給每個 repo 開獨立帳號 = 多帳號自動化 = 踩下方第 4 節 flag 鐵律，**不可**。
+身份只能在**內容層自報**。本 repo 名稱 → 看 `git remote -v` 或 repo 根目錄名。
+
+---
+
+## 4. flag 安全界線（最重要 — 絕不可越）
+
+**「有事才讀」，禁止自動輪詢。**
+
+- ✅ 想看 issue → 當下主動 `gh issue list`。
+- 🚫 **禁止**掛 GitHub Actions / cron / webhook 去**自動輪詢** issue。
+
+為什麼這條是硬底線：自動輪詢 + 事件 fan-out 正是會觸發 GitHub 異常偵測、
+害你的 token 被 rate limit 砍掉的流量模式。template 給很多人用，這條界線必須守住，
+保護使用者不踩雷。需要「定期檢查」就由人類主動跑這個指令，不要自動化。
+
+---
+
+## （可選）用 label 分來源
+
+若想用同一套流程同時管「內部交辦」與「外部回報」，可建兩個 label：
+`internal`（協作/交辦）、`user`（外部使用者回報），靠 label 分流。
+這對通用 template 不預設——你的 repo 需要再建。

templatefs/.claude/commands/sdd-check.md

@@ -0,0 +1,75 @@
+# /sdd-check — 確認當前任務有沒有對應 SDD
+
+動手前執行。確保 CC 有全局觀，不會在沒有設計文件的情況下猛衝。
+
+---
+
+## 生命週期（單一活性鐵律，全文見 `system-dev/docs/3-specs/SDD-LIFECYCLE.md`）
+
+五條鐵律摘要：
+
+1. **單一活性**：任何時刻整個 repo 只允許一份 `status: active` 的 SDD；所有開發任務對應它的 tasks，找不到對應任務 → 停下來問，不准直接做。
+2. **禁止自行建立 SDD**：澄清問題→回答不動文件；任務層變更→更新現行 SDD 的 tasks（標日期與原因）；規格層變更→走第 3 條。
+3. **規格變更只有一條路**：change proposal 寫進 `system-dev/docs/3-specs/pending-changes.md`（摘要＋觸發原因＋影響分析），然後**停止**等使用者「confirm」。
+4. **開新 SDD 的唯一時機**：使用者 confirm 後——先把舊 SDD 未完成任務逐條搬入新 SDD（做完前不准寫 code）→ 舊的標 `closed` + `superseded_by` 移入 `archive/` → 新 SDD changelog 記繼承 → 列搬移/作廢清單請最終確認。
+5. **每次 session 開始**先讀 active SDD 與 pending-changes.md，回報三個數字：
+
+   ```
+   📐 現行規格：〈SDD 名稱〉
+   📋 未完成任務：N
+   ⚖️ 待裁決 proposal：M
+   ```
+
+   若出現**兩份 active＝規則已被違反，當場糾正**（收斂到一份，其餘 paused/closed）。
+
+---
+
+## 執行流程
+
+### 第一步：理解任務
+
+確認使用者要做什麼：
+- 涉及哪個子系統？
+- 是新功能還是修改現有功能？
+- 影響範圍？
+
+### 第二步：尋找對應 SDD
+
+在 `system-dev/docs/3-specs/` 下尋找對應的子系統目錄，確認有沒有：
+- `design.md`（設計文件）
+- `tasks.md`（任務清單）
+
+### 第三步：根據結果回應
+
+**情況 A：找到對應 SDD**
+```
+✅ 找到 SDD：system-dev/docs/3-specs/[子系統]/
+📋 design.md：[確認]
+📋 tasks.md：[確認，列出相關 task]
+🎯 對應 task：[編號和描述]
+繼續嗎？
+```
+
+**情況 B：找不到 SDD，任務明確**
+```
+⚠️ 找不到對應 SDD
+任務：[描述]
+建議在 system-dev/docs/3-specs/[建議子系統名]/ 建立 SDD
+
+要我幫你起草 design.md 嗎？（需要你確認後才動手）
+```
+
+**情況 C：找不到 SDD，任務模糊**
+```
+⚠️ 找不到對應 SDD，而且任務範圍不夠清楚
+請先回答：
+1. 這個功能屬於哪個子系統？
+2. 完成的標準是什麼？
+3. 有沒有不能動的邊界？
+```
+
+### 注意
+
+- 找不到 SDD **不等於可以直接動手**
+- 小修改（修 bug、改文字）可以豁免，但要明確說「這是小修改，範圍是 X」
+- 新功能、架構變動、跨模組的修改 → 一定要有 SDD

templatefs/.claude/commands/wiki-capture.md

@@ -0,0 +1,69 @@
+# /wiki-capture — 把對話結論存進 wiki
+
+把這次對話中產生的決策、誤解釐清、或重要結論存入 wiki。
+解決「討論過了但知識消失」的問題。
+
+---
+
+## 執行流程
+
+### 第零步：機敏檢查（寫入前一律先過）
+
+把任何內容寫進 wiki 前，先確認**不含**密碼 / API 金鑰 / 私鑰 / 連線字串帳密 / 個資（身分證、信用卡）。
+- 命中 → 不要記「值」，改記「位置」（例：「DB 密碼放 `.env`，不入 wiki」）
+- 來源整檔機敏 → 提醒使用者加進 `system-dev/wiki/.wikiignore`
+- 真要保留示範格式 → 該行尾加 `wiki-secret-ok` 標記
+> 這是協議層自律。最後一道 `wiki-secret-scan.sh` hook 會在寫入 `system-dev/wiki/` 時機械攔截，但別依賴它兜底——當場就不要把機敏值帶進來。
+
+### 第一步：辨識對話中的可記錄內容
+
+掃描當前對話，找出：
+
+| 類型 | 判斷標準 | 存到哪 |
+|------|---------|-------|
+| 架構決策 | 「為什麼選A不選B」「我們決定用X」 | `decisions-summary.md` + `system-dev/docs/2-architecture/decisions/` |
+| CC 的誤解被糾正 | CC 說了某件事，使用者說「不是，是...」 | `mistakes.md` |
+| 重要狀態更新 | 完成了某件事、阻擋了某件事 | `status.md` |
+| 技術發現 | 踩到坑、找到解法、重要行為確認 | `mistakes.md` 或對應 SDD |
+
+### 第二步：列出清單給使用者確認
+
+格式：
+```
+這次對話我整理了以下內容要存入 wiki：
+
+1. [MISTAKE] CC 誤解了 X，正確是 Y
+2. [DECISION] 決定用 A 不用 B，原因是 C
+3. [STATUS] 完成了 task 2.3，下一步是 2.4
+
+確認後存入，有需要修改的嗎？
+```
+
+**停下來等確認。**
+
+### 第三步：寫入
+
+確認後，依照格式寫入對應檔案：
+
+**mistakes.md 格式：**
+```
+⚠️ MISTAKE: [錯誤描述]
+   症狀: [CC 的表現]
+   正確做法: [應該怎麼做]
+   原因: [背景]
+   日期: [YYYY-MM-DD]
+```
+
+**decisions-summary.md 格式：**
+```
+## [主題] — [YYYY-MM-DD]
+**結論**：[一句話]
+**原因**：[簡短說明]
+**詳細**：system-dev/docs/2-architecture/decisions/[檔名]
+```
+
+重大決策同時在 `system-dev/docs/2-architecture/decisions/` 建立 ADR 檔案。
+
+### 第四步：確認
+
+告知存到哪些檔案，共幾條記錄。

templatefs/.claude/commands/wiki-extract.md

@@ -0,0 +1,161 @@
+# /wiki-extract — vault 增量萃取（Logseq / Obsidian → system-dev/wiki）
+
+把**筆記 vault**（Logseq graph 如 `notes`/`kb`、或 Obsidian）的原始筆記，**增量、冪等**地
+萃成 `system-dev/wiki/` 的精耕卡＋`[[wikilink]]`。這是知識一庫 ingest 的**前段**：
+AI 只產卡片檔，下游 Arcrun ingest 再從 wikilink 機械拉三元組進 KBDB。
+
+> **跟 `/wiki-init` 的分工**：
+> - `/wiki-init` 是**首次**建結構 + 全庫首萃（一次性）。
+> - `/wiki-extract` 是**之後每次**的增量重萃——vault 會被 Syncthing/cron 持續灌新筆記，
+>   這支負責「只萃變動的、沒變的不碰、不浪費 AI run」。給 Routine / cloud-worker 反覆跑。
+> - **跑它的是你（CC / Routine）＝LLM 本人，不需任何 token**。
+
+> **邊界（硬規矩，別越界）**
+> - 只往 `system-dev/wiki/` 寫。**絕不寫入 KBDB、絕不拉三元組紀錄**——三元組是下游
+>   Arcrun 從你產的 `[[wikilink]]` + `## 關聯` 機械映射（另一張 issue），不是這支的事。
+> - **原始筆記唯讀**：`journals/`、`pages/`、Obsidian 根 `.md` 是 leo 的手寫真身，
+>   改了會被 Syncthing 推回他手機污染筆記 App。萃取＝只讀原文、只寫 wiki。
+> - **D16 精耕非 RAG**：萃「知識點」成自包含原子卡 + 建 wikilink，**不地毯灌原文全文**。
+
+---
+
+## 執行流程
+
+### 第一步：確認這是 vault repo，定位 raw source
+
+偵測邏輯**同 install.sh / wiki-init**：
+
+| 偵測到 | 型態 | raw source（要掃的原文） |
+|--------|------|--------------------------|
+| 根目錄有 `logseq/` | Logseq vault | `journals/*.md` + `pages/*.md` |
+| 根目錄有 `.obsidian/` | Obsidian vault | vault 根下所有 `.md` |
+| 都沒有 | **不是 vault** | → 停手。這支只處理 vault；一般 dev repo 開發時就手寫 `.claude`/`system-dev/wiki`，不需萃取 |
+
+沒有 `system-dev/wiki/`？→ 先跑 `/wiki-init`（首次建結構＋首萃），再回來用這支做增量。
+
+### 第二步：content_hash 冪等 —— 決定哪些檔要萃（省 run 的核心）
+
+讀萃取 manifest：`system-dev/wiki/.extract-manifest.json`（不存在＝首次，視同全部要萃）。
+格式：
+
+```json
+{
+  "version": 1,
+  "algo": "sha256",
+  "sources": {
+    "journals/2026_07_01.md": {
+      "content_hash": "<sha256 of file bytes>",
+      "extracted_at": "2026-07-06",
+      "cards": ["Prompt能力即拆解自己邏輯的能力", "程式化邏輯可圖解任何主題不限AI"],
+      "skipped_reason": null
+    },
+    "journals/2026_06_25.md": {
+      "content_hash": "<sha256>",
+      "extracted_at": "2026-07-06",
+      "cards": [],
+      "skipped_reason": "空檔／訊息量不足，無可萃知識點"
+    }
+  }
+}
+```
+
+對每個 raw source 檔：
+
+1. 算目前 `content_hash`（`sha256sum <file>`，取檔案 bytes 的 hash）。
+2. 跟 manifest 裡該檔的 `content_hash` 比：
+   - **相同 → skip，不讀不萃、不呼叫任何 AI 推理**（就算它上次 `cards: []` 也 skip——空檔沒變還是空）。
+   - **不同或不在 manifest → 這檔要（重）萃**。
+3. manifest 有、但檔已不存在 → 該檔被刪，把它的 entry 從 manifest 移除（卡片是否連帶處理見第五步）。
+
+> **這一步是「省 run」的重點**：vault 每天可能只動 1～2 個 journal，其餘幾十個檔 hash 沒變
+> 就整批跳過，AI 只對真正變動的檔動腦。**重跑一個沒變動的 vault ＝ 零 AI 呼叫、零 diff。**
+
+### 第三步：對「要萃」的檔，抓知識點 + 任務
+
+逐個變動檔讀原文，分兩類抽取：
+
+**(a) 知識點 → 概念原子卡**
+判準與卡片格式**完全依 `/wiki-init` 第五步**（frontmatter `tags:`/`gloss:`、H1、麵包屑
+`← [[<bucket>/00-INDEX]]`、`**來源**`、`## 摘要`、`## 重點`、`## 實體`、`## 關聯` 的
+typed-edge 三元組、TAXONOMY 受控標籤、硬自檢等）——**不在這裡重寫格式，一律回去讀那份**。
+廢話/訊息量薄的段落略過（在 manifest 記 `skipped_reason`，誠實留痕、不留卡）。
+
+**(b) Logseq 任務 marker → 任務卡（task_status）**
+解析**完全依** `system-dev/docs/4-guides/logseq-markers.md`（單一真相源，與 template#4
+tasks 投影共用同一套；**別自己另寫 mapping**）。摘要：
+
+- 任務行 regex：`^\s*- (TODO|DOING|NOW|LATER|WAITING|DONE|CANCELED|CANCELLED)\s+`
+- 狀態正規化：TODO/LATER→`todo`、DOING/NOW→`in-progress`、WAITING→`blocked`、
+  DONE→`done`、CANCELED/CANCELLED→`closed`。
+- 跳過 `:LOGBOOK:…:END:` 區塊與 `key:: value` 屬性行（`collapsed::`、`id::`、
+  `SCHEDULED::`、`DEADLINE::`…），**別把 marker 或屬性當任務內文**。
+
+有實質內容的任務 → 產一張任務卡進 `cards/tasks/` bucket，frontmatter 帶 `task_status`：
+
+```markdown
+---
+tags: [<領域標籤，依 TAXONOMY>]
+task_status: todo        # ← 依上表正規名；這是任務卡才有的欄位
+gloss: 一句話定義這個任務要達成什麼（供下游 normalize）
+---
+# <任務一句話標題（marker 後的內文，去掉 marker）>
+
+← [[tasks/00-INDEX]]
+
+**來源**：`journals/2026_07_01.md`（TODO block）
+**最後更新**：YYYY-MM-DD
+
+## 摘要
+[任務要做什麼、脈絡]
+
+## 實體
+- **<關鍵實體正規名>**（<同義詞>）— <一句描述>
+
+## 關聯
+### 內文知識關係（端點＝上方 `## 實體` 正規名，一字不差）
+- <實體A> >> <謂詞> >> <實體B>
+### 卡片關係（卡對卡）
+- [[本任務卡]] >> 涉及 >> [[相關概念卡]]
+```
+
+> 純瑣事任務（「買菜」這種無知識量）不必成獨立卡——可在 `cards/tasks/00-INDEX.md`
+> 列一行帶狀態即可，避免灌垃圾卡。判準同 D16：有沒有知識/專案價值。
+
+### 第四步：更新桶索引與 INDEX
+
+- 每個動到的 bucket（如 `cards/notes/`、`cards/tasks/`）更新其 `00-INDEX.md`
+  （容器：只連不重寫，H2/H3 分節）。
+- 更新 `system-dev/wiki/INDEX.md` 的標籤視圖與卡片清單。
+- 任務卡可在 INDEX 開一個「任務視圖」按 `task_status` 聚類。
+
+### 第五步：寫回 manifest + 驗證原文 0 動
+
+1. 把這次萃過的每個檔的**新 `content_hash`**、`extracted_at`、產出的 `cards`、
+   （或 `skipped_reason`）寫回 `system-dev/wiki/.extract-manifest.json`。
+   **沒動到的檔的 entry 原樣保留**（別整檔重寫掉別人的 hash）。
+2. 驗證原文零異動（踩過的坑）：
+   ```
+   git status --short journals/ pages/    # Obsidian 則看根目錄 .md ——須 0 新增 0 修改
+   ```
+   有任何原文變動 → 你誤寫了 raw source，回滾。
+
+### 第六步：完成報告
+
+```
+✅ wiki-extract 完成（增量）
+掃描：N 個 raw source 檔
+  萃取：M 個（content_hash 變動）→ 產出 X 張概念卡 + Y 張任務卡
+  跳過：K 個（hash 未變，零 AI 呼叫）
+任務狀態分布：todo A / in-progress B / done C / …
+原文驗證：journals/ pages/ git status 0 異動 ✅
+manifest：system-dev/wiki/.extract-manifest.json 已更新
+```
+
+---
+
+## 冪等自檢（Routine 反覆跑必守）
+
+- [ ] 跑之前先讀 manifest，hash 相同的檔**完全不進 AI**（不是「讀了才發現一樣」，是靠 hash 先擋）。
+- [ ] 對「同一個沒變動的 vault」連跑兩次：第二次應是**零萃取、零卡片 diff、零 manifest 變化**。
+- [ ] 只有 `system-dev/wiki/` 有寫入；`journals/`、`pages/` git status 全乾淨。
+- [ ] 任務狀態用正規名，marker/屬性沒混進內文（照 `logseq-markers.md` 自檢）。

templatefs/.claude/commands/wiki-init.md

@@ -0,0 +1,235 @@
+# /wiki-init — 初始化或接入 LLM Wiki 系統
+
+初始化這個專案的 LLM Wiki 記憶系統。
+新專案建立空白結構，已有專案掃描現有文件並**改寫**成 wiki。
+
+---
+
+## 核心概念：wiki 是 AI 改寫過的記憶，不是原文索引
+
+記憶系統的目的，是讓 AI **之後讀得快**。但人類寫的原始文件——不管是 vault 的隨手記、開發專案的會議記錄、規格草稿、散落的 `.md`——天生是亂的：重複、流水帳、半成品、口語。
+
+如果 wiki 只是一份 `[[原文檔名]]` 指回原文的**索引**，那每次未來要用都得重新解析那團亂，等於沒省到。**wiki 的價值在於「改寫一次，之後每次讀都便宜」**。
+
+所以原則對**所有專案**一致（不分 vault 或一般開發）：
+
+> 人類寫的原文是 **SSoT**（真理來源，永遠唯讀）。
+> 但實際要長期保存、被 AI 反覆讀的是 **AI 改寫整理過的 wiki**。
+> **AI 是總編輯**——把原文改寫成自包含、概念原子化、互相連結、適於 AI 讀的知識條目。
+
+唯一例外：原文是**不可改動的正式文件**（簽署過的規格、法規、合約），必須逐字讀原文——這種才在 wiki 裡用指針指回去，並註明「逐字依原文」。除此之外，一律改寫。
+
+**raw source 永遠唯讀**：所有產出只往 `system-dev/wiki/` 寫，絕不改動、搬移、重新命名原文。
+
+---
+
+## 執行流程
+
+### 第一步：偵測專案狀態
+
+檢查以下項目，判斷是新專案還是已有專案：
+- 根目錄有沒有 `system-dev/wiki/`
+- 根目錄有沒有 `docs/`（或 vault 的 `pages/`、`journals/`、根目錄 `.md`）
+- 有沒有散落的 `.md` 檔案
+
+同時**偵測 raw source 路徑**（同 install.sh 邏輯）：
+- 根目錄有 `logseq/` → Logseq vault，raw source = `pages/` + `journals/`
+- 根目錄有 `.obsidian/` → Obsidian vault，raw source = 根目錄所有 `.md`
+- 都沒有 → 一般專案，raw source = `docs/` 下所有 `.md`（及散落的 `.md`）
+
+**新專案**（幾乎空的）→ 直接建立結構，跳到第三步
+**已有專案**（有文件）→ 執行第二步
+
+### 第二步：已有專案的掃描（已有專案才執行）
+
+1. 遞迴找出 raw source 裡所有 `.md` 檔案
+2. **先套用 `system-dev/wiki/.wikiignore`**：命中 pattern 的檔案整個排除，不讀不編入。
+   - 若 `.wikiignore` 不存在，從範本建立一份（預設排除 `.env`/`*.pem`/`*secret*` 等）
+   - 被排除的檔案在清單裡標「🚫 .wikiignore 排除」，**不可被覆蓋**
+3. 對其餘檔案標注**改寫計畫**：會萃取成哪些 wiki 條目。一份原文可能拆成多個概念原子條目，多份相關原文也可能合併成一條。
+4. 列出清單給使用者確認，**停下來等確認**
+
+> **量大時建議用 Haiku 改寫**：逐份原文「改寫成 wiki 格式」是重複、機械、判斷成本低的工作——正適合 Haiku。原文數量多（如數十、上百份）時，主動建議：
+> 「共 N 份原文要改寫，這類逐份萃取很適合用 Haiku 並行處理（便宜、夠快）。要我派 Haiku subagent 改寫嗎？」
+> 得同意後，用 Task / subagent 把每份原文（或每批）丟給 Haiku 改寫，主模型只負責切分概念、定條目邊界、最後審稿與互連。
+
+> 機敏防護（三層）：
+> - **L1 .wikiignore**：整檔排除（這一步）
+> - **L2 行內標記**：檔案要編入但某段不要 → 遇到 `<!-- wiki:ignore -->` … `<!-- wiki:end -->` 之間的內容**略過**，只留「（此處機敏，已略過）」
+> - **L3 hook**：萬一機敏值仍被寫進 wiki，`wiki-secret-scan.sh` 會 exit 2 擋下
+> 編入任何檔案前，先檢查是否含密碼/金鑰/個資——有就改記「位置」而非「值」。
+
+### 第三步：建立缺少的結構
+
+只建立不存在的目錄和檔案，**已有的一律不動**。
+
+wiki 採**三層 + 標籤橫切**架構（183 卡實證，issue #8）：
+
+```
+system-dev/wiki/
+├── INDEX.md              ← 索引：多角度視圖的家（標籤角度、決策角度、…）
+├── TAXONOMY.md           ← 標籤字典（cards 的分類元資料，受控擴充）
+├── status.md             ← [push] 時態狀態：當前進度、下一步
+├── mistakes.md           ← [push] 踩過的坑、被糾正的誤解（防不自覺盲區）
+├── principles.md         ← [push] 跨全局的設計原則（行動前必服從）
+└── cards/                ← [pull] 一切知識內容：原文摘要、AI 筆記、決策、概念…
+    └── <bucket>/         ← 儲存桶（分類由 frontmatter 標籤承載）
+        ├── 00-INDEX.md   ← 桶子索引（固定名，容器：只連不重寫，H2/H3 分節）
+        └── <概念全名>.md  ← 概念原子卡（一概念一檔，自包含）
+```
+
+> **[push] / [pull] 是這套 wiki 的核心判準——因為 wiki 主要是給 AI（CC）看的。**
+> 見下方「核心判準：push vs pull」。`decisions-summary.md` 已**降級為 cards + INDEX 決策視圖**（決策是知識內容＝card）；既有的 decisions-summary 若存在，保留為相容，不刪。
+
+關鍵原則：**資料夾只是儲存桶，分類由 frontmatter 標籤承載**。資料夾名不該硬繼承原稿目錄——原稿目錄是「人為了整理草稿」分的，wiki 連分類都該由 AI 重新組織。
+
+> **桶子索引固定叫 `00-INDEX.md`**（issue #6）：`00-` 前綴讓它排序最前、一眼可辨（像 README 之於資料夾），AI 載入任何 `cards/<bucket>/` 一律先讀它，不必猜。檔內 H1 仍寫主題名（如 `# PKM 知識管理`），語意不丟。
+
+一般專案仍可同時建 `system-dev/docs/` 分類樹（SDD 等）：
+```
+system-dev/docs/{1-vision,2-architecture/decisions,3-specs,4-guides,5-records/{incidents,test-reports},6-user}
+```
+（純 PKM vault 不需要 `system-dev/docs/` 分類樹時，只建 `system-dev/wiki/`。）
+
+檔案（不存在才建）：
+- `system-dev/wiki/INDEX.md`、`TAXONOMY.md`
+- `system-dev/wiki/status.md`、`mistakes.md`、`principles.md`（三個 push 檔）
+- `system-dev/docs/README.md`（一般專案才需要）
+
+---
+
+## 核心判準：push vs pull（wiki 是給 AI 看的）
+
+整理任何內容前，先判斷它該 **push** 還 **pull**——判準是「**CC 做事時會不會被動看見**」：
+
+- **push**：CC 行動前必須主動出現在 context（session 開始就由 hook 注入）。給「CC 不會主動去查、但不看就出事」的東西。
+- **pull**：CC 想到要查、或載入相關卡時才看見。給「CC 面對它時自然會查」的知識。
+
+**為什麼這是核心**：mistakes 防的是 CC「不自覺的盲區」——一個你不知道存在的錯，你不會主動去檢索它。靠 CC 自覺去查自己沒自覺的盲區是自相矛盾的，所以 pull 對盲區失效，**必須 push**。原則同理：沒被推到眼前的準繩，CC 設計時很可能沒想到要服從就做了。
+
+| 內容 | push/pull | 注入形態（hook）|
+|------|-----------|----------------|
+| **status** | push | **全文**——CC 必須知道精確的下一步，摘要會漏 task 編號 |
+| **principles** | push | **全文（一行一條）**——短而硬的約束，漏一條就違反；≤15 條，超過代表該下放成 card |
+| **mistakes** | push | **標題清單 + 一行症狀**，全文按需 pull——量可能大，摘要足以觸發「我正撞到某條」的認出 |
+| **decisions、原文摘要、概念知識、一切其餘** | pull | 寫成 cards；CC 面對時自然會查，INDEX 提供角度入口 |
+
+**principles 維護規則**：一行一條精煉準繩（如「不污染用戶根目錄」「目標用戶 low-code」「wiki 主要給 AI 看」）。發現新的跨全局原則 → append 一行；超過 ~15 條代表某些該合併或下放成 card。**累積原則只改 principles.md，不必問用戶開新檔。**
+
+### 第四步：訪談（每次一個問題）
+
+依序問：
+1. 這個專案做什麼？（一句話）
+2. 有哪些絕對不能違反的限制？（技術棧、架構原則等）
+3. 現在進行到哪個階段？
+4. 有沒有 CC 曾經犯過的錯要先記下來？
+
+把答案填進 `CLAUDE.md`（如果存在）或建立新的。
+
+### 第五步：改寫成 wiki（AI 當總編輯）
+
+（第二步確認後執行）
+
+**不搬動原文**。逐份讀 raw source，改寫萃取成 `cards/<bucket>/` 裡的自包含原子卡：
+
+- **概念原子化**：一張卡講一個概念，不是一篇原文對一張卡。原文太雜就拆，多份相關原文就合。
+- **自包含**：讀卡就懂，不必回去翻原文。把口語、重複、流水帳改寫成結構化知識，**不寫「詳見原文」**。
+- **保留來源指針**：每卡標 `**來源**：原文相對路徑`，為可追溯，不是要使用者回去讀。
+- **frontmatter 標籤分類**（見下方）：分類走 frontmatter `tags:`，不靠資料夾、不靠行內 `#tag`。
+- **互相連結（typed-edge 三元組）**：`## 關聯` 不只列裸 `[[頁面]]`，改寫成帶語義的三元組（見下方）。
+- **萃 gloss（node 一句說明）**：frontmatter 放 `gloss:` —— 這張卡（= 一個 entity / graph node）的一句話定義，供下游語義 normalize（見下方）。
+
+卡片格式（每張卡）：
+```markdown
+---
+tags: [知識管理, AI協作, 方法論]
+gloss: 一句話定義這個概念是什麼（給下游語義 normalize 用，選填、deep tier 才產）
+---
+# 概念全名
+
+← [[<bucket>/00-INDEX]]
+
+**來源**：`[raw source 相對路徑]`
+**最後更新**：YYYY-MM-DD
+
+## 摘要
+[一句話核心]
+
+## 重點
+- [自包含改寫的要點，不依賴原文]
+
+## 實體
+> 本卡內文的關鍵實體（也是 graph node）。名＋描述供下游 embedding normalize。集中放、一行一個、不縮排、不重複。
+- **原子筆記**（atomic note／卡片原子化）— 每張卡只承載一個不可再分論點的知識記錄單元。
+- **傳統筆記**（大鍋炒筆記）— 把多主題混雜在同一篇、難精確引用的記錄方式。
+
+## 關聯
+### 內文知識關係（內文實體間；端點＝上方 `## 實體` 正規名，一字不差）
+- 原子筆記 >> 對立於 >> 傳統筆記
+### 卡片關係（卡對卡）
+- [[本卡]] >> 謂詞（動詞短語） >> [[他卡]]
+```
+
+**麵包屑用帶路徑 wikilink**（issue #7）：H1 次行放 `← [[<bucket>/00-INDEX]]` 指回桶子索引。
+桶子索引固定名 `00-INDEX` 跨桶會撞名，故**指 00-INDEX 一律帶路徑**（`[[pkm/00-INDEX]]`，Logseq 原生支援、下游 ingest 也能對應到具體檔）。普通卡片間連結仍用裸 `[[卡名]]`（卡名唯一，不需路徑）。
+
+**frontmatter 標籤分類**（issue #8）：
+- **用 frontmatter `tags:` 而非行內 `#tag`**：卡片內文常大量用 `#`（講筆記法時的 `#猜想`、`#book100`），分類標籤若也行內 `#`，下游 ingest 無法區分「分類」與「內文範例」會污染 graph。frontmatter 與內文完全分開，零歧義。
+- **用標籤而非資料夾分類**：資料夾＝強制單一歸屬；標籤＝多重歸屬。一張卡可同時屬知識管理＋AI協作＋架構設計，硬塞一個資料夾會在其他檢索角度漏掉。
+- **雙軸 taxonomy**（寫進 `TAXONOMY.md` 當字典；**受控擴充**，非凍結）：
+  - 領域（主軸，1-3 個）：如 知識管理／學習認知／AI協作／生產力／系統設計／工具教學
+  - 形態（副軸，0-2 個）：方法論／工具實作／觀點主張／架構設計／案例經驗
+  - 一般開發專案的軸可不同（如 子系統／層級／決策類型），由 AI 依專案性質提出、寫進 TAXONOMY.md。
+  - **遇到現有軸裝不下的內容**：先查是否只是現有標籤的同義詞；確實是新軸才加進 TAXONOMY.md（附定義）再用——**禁止繞過字典在卡片直接冒新標籤**。字典是 per-repo，跨 repo 不必共用。
+
+**typed-edge 規則**（issue #5/#11，把「關係」也預編譯，下游 ingest 直接 parse 出帶類型的有向邊）：
+- **重點抓內文實體關係，不只卡對卡**：卡對卡（`[[卡A]] >> 謂詞 >> [[卡B]]`）只是既有雙鏈加動詞、資訊量幾乎沒增加；價值在內文概念關係（`原子筆記 >> 對立於 >> 傳統筆記`，A/B 是內文概念非卡標題）。
+1. **方向性**：`A >> 謂詞 >> B` 必須讀成「A（謂詞）B」一句通順的話；A、B 順序就是主→賓真實方向。
+2. **謂詞用動詞 / 動詞短語**（反駁、奠基於、犧牲）。**禁名詞當謂詞**——`>> 存儲格式 >>`、`>> 操作體驗 >>` 讀不通，是錯的。
+3. **謂詞自由但別太天馬行空**：「參考／參照」皆可（下游 embed 自動聚類），別寫「瞄了一眼」這種抓不到同義的。
+4. **內文三元組端點用裸文字**（非 `[[wikilink]]`），避免 Logseq 紅色斷鏈；卡對卡那層才用 `[[]]`。
+5. **向後相容**：純 `[[A]]` 仍合法（視為無類型邊），盡量補謂詞。
+
+> **★ 硬自檢（Haiku 量產必備）★** 內文三元組端點必須與 `## 實體` 某粗體正規名【一字不差】。**寫完逐條把 A、B 拿去 `## 實體` 比對**，沒有完全相同的 → 這條錯了，改用實體表已有的詞、或把端點補進 `## 實體` 再指它。禁止端點帶括號註解／整句補語／形容詞短語。（實證：光寫規則 Haiku 會略過，端點對不齊 14 條；寫成自檢動作後 14→0。跑 12 張才暴露。）
+> `>>` 是分隔語法，repo 可自選符號，但全程一致。
+
+**萃 gloss 規則**（issue #9/#11，把「node 的一句說明」也預編譯，供下游 KBDB 語義 normalize）：
+- **gloss = 這個 entity / graph node 是什麼的一句話**。下游對「entity 名 + gloss」一起做 embedding 求相似度，自動歸一同義詞（比只對名字準、比手維護 alias 表自動）。
+- **兩層 gloss**：① frontmatter `gloss:` 描述卡標題這個 node；② `## 實體` 每行描述句描述內文實體 node。**內文實體也是 graph node、也需描述句**才能 normalize（`黃仁勳` vs `Jensen Huang` 靠描述拉近向量）。
+- **實體要描述、謂詞不用**：實體同義詞字面差遠需描述拉近；謂詞同義詞字面本就近，裸詞 embed 自動聚類。
+- **在知識生產的當下、由 local CC 建**：gloss 跟三元組同階段萃，**不留給下游 ingest 臨時補**——下游只有單檔 / 跨庫視角，編不出貼合的 gloss（＝胡扯）。
+- **選填、deep tier 才產**：淺萃（只要結構）時不浪費；deep 改寫時每張卡補。
+- **gloss ≠ 摘要**：`gloss` 是給機器 normalize 的定義句（「X 是…」）；`## 摘要` 是給人讀的核心一句。
+- **格式對齊下游 envelope**：frontmatter `gloss:` 與 `## 實體` 詞條對應下游 ingest envelope 的 `nodes[].gloss`，ingest 直接取用。
+
+**INDEX.md 是標籤視圖**（非資料夾列表），`00-INDEX.md` 是桶內容器（只連不重寫，H2/H3 分節）。
+頂層索引指桶子索引帶路徑：`[[pkm/00-INDEX]]`。
+
+> 與 claude.ai Cowork 的 `system-dev/docs/SKILL.md` 改寫邏輯一致，兩條路徑（CC / Cowork）產出同一種 wiki。
+
+### 第六步：完成報告 + 驗證
+
+完成後**驗證原文 0 動**（踩過的坑，issue #8）：
+```
+git status --short pages/ journals/    # 或一般專案的 docs/ ——須 0 新增 0 修改
+```
+
+> **改寫時必守**（subagent 尤其）：
+> 1. **絕不寫入 raw source**：subagent 目標一律給絕對路徑到 `cards/<bucket>/`，明寫「絕不寫入 pages/journals/docs 原稿」；事後用上面的 `git status` 驗。
+> 2. **檔名 = 卡片全名**，否則 `[[全名]]` 對不到檔。冒號用全形「：」、斜線用全形「／」，**全程一種字元**，避免 `/`、`∕`、`：` 混用斷鏈。
+> 3. **量大用 Haiku 並行改寫**，主模型只切概念邊界＋審稿＋修跨資料夾斷鏈。
+
+告知：
+```
+✅ wiki-init 完成
+建立了：[列出新建的目錄和檔案]
+跳過了：[列出已有因此不動的]
+改寫了：[N 份原文 → M 張原子卡、K 條 typed-edge、M 條 gloss（deep tier）]
+原文驗證：pages/ journals/ git status 0 異動 ✅
+下一步：用 /wiki-capture 把重要決策存進 wiki
+```
+
+> **vault repo 首萃後的增量重萃**：Logseq / Obsidian vault 會被持續灌新筆記。首萃（本命令）
+> 之後，改用 **`/wiki-extract`** 做增量——它靠 content_hash 只萃變動的檔（沒變＝零 AI 呼叫），
+> 並解析 Logseq 大寫任務 marker（TODO/DOING/DONE…→ `task_status`，見
+> `system-dev/docs/4-guides/logseq-markers.md`）。適合掛給 Routine / cloud-worker 反覆跑。

templatefs/.claude/commands/wiki-recall.md

@@ -0,0 +1,58 @@
+# /wiki-recall — Session 開始，手動接關
+
+開新對話時接上次進度。**Fallback 命令**：SessionStart hook 沒啟動時手動接關；要完整脈絡時也用。
+
+> 主路徑是 SessionStart hook 自動注入 status 重點，不靠你打命令。
+> 這支命令應對 hook 失效，以及需要比「status 重點」更完整脈絡的時候。
+
+---
+
+## 命名閉環
+
+init(建) → update(存，session 末) ↔ **recall(接，session 初)** → capture(隨時存結論)
+
+---
+
+## 執行流程
+
+### 第一步：讀 status.md（當前進度）
+
+讀 `system-dev/wiki/status.md`，掌握：
+- 正在做什麼、阻擋點
+- 下次 session 第一件事
+- 待負責人確認、已知問題
+
+### 第二步：讀 decisions-summary.md（為什麼這樣做）
+
+讀 `system-dev/wiki/decisions-summary.md`，掌握相關的架構決策——避免重新討論已定案的事。
+
+### 第三步：讀 mistakes.md（別重犯）
+
+讀 `system-dev/wiki/mistakes.md`，掌握已知誤解 + 快速檢查清單。
+
+### 第四步：掃 wishlist / HANDOFF（如果有）
+
+- `docs/wishlist.md`：待補功能
+- 任何 `HANDOFF.md` / 交接note：上一棒留下的脈絡
+
+### 第五步：回報接關結果
+
+```
+📍 接關完成
+🔄 上次正在做：[status 的「正在做」]
+🎯 下次第一件事：[status 的「下次 session 第一件事」]
+⚠️ 待確認：[如有]
+```
+
+---
+
+## 鐵律：快照非即時狀態
+
+status / wiki 是 **point-in-time 快照，不是即時狀態**。
+
+接關 ＝ 讀快照 **＋ 核實快照**，**不盲信**。
+
+> 實例：某專案 status 曾寫「待 A 收尾 X」，實際 X 早已完成。
+> 照舊資訊行動會去催一件已完成的事。
+
+動手前，先用當前 code / git / 檔案核實快照寫的事項是否仍成立。發現落差 → 先更新 status，再動手。

templatefs/.claude/commands/wiki-update.md

@@ -0,0 +1,50 @@
+# /wiki-update — Session 結束，更新狀態
+
+每次 session 結束時執行。更新 status.md，確保下次 session 能無縫接上。
+
+---
+
+## 執行流程
+
+### 第一步：整理這次 session 的結果
+
+從對話中提取：
+- 完成了哪些 tasks（標記為 [x]）
+- 進行中但未完成的（標記為 [🔄]）
+- 遇到什麼問題或阻擋
+- 下次應該從哪裡開始
+
+### 第二步：更新 tasks.md
+
+把對應 SDD 的 tasks.md 狀態更新（如果這次有動到的話）。
+
+### 第三步：更新 status.md
+
+用以下格式覆蓋 status.md：
+
+```markdown
+# 當前狀態
+> 更新時間：[YYYY-MM-DD]
+
+## 正在做
+- [🔄] [task 描述] — 阻擋點：[如果有]
+
+## 下次 session 第一件事
+[具體的第一個動作，越具體越好]
+
+## 待負責人確認
+- [描述] — 等待：[什麼決定]
+
+## 已知問題
+| 問題 | 優先級 | 狀態 |
+|------|--------|------|
+| [問題] | 🔴/🟡/⚪ | [狀態] |
+```
+
+### 第四步：如果有新的誤解或決策
+
+順帶執行 `/wiki-capture` 的邏輯，把這次的誤解和決策也存進去。
+
+### 第五步：確認
+
+告知 status.md 更新完成，下次 session 從哪裡開始。

templatefs/.claude/hooks/pre-write-guard.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+# PreToolUse hook 範本骨架 —— 專案自訂禁令（預設空殼，不攔任何東西）
+#
+# ⚠️ 定位（讀清楚再用）：
+#   這支跟其他三支 hook 不同——它不是「裝上就生效的警察」，而是一個「按需手填的
+#   空插槽」。預設狀態下 FORBIDDEN_PATTERNS 是空的，它【不攔任何東西】。
+#   別誤以為裝了它就有保護——空殼 = 沒保護。
+#
+# 🤖 有 CC 在場的話，通常不需要這個範本：
+#   直接叫你的 CC「幫我寫一支 guard hook，禁止改 X」。CC 現寫的條件邏輯，
+#   表達力遠勝這裡的 glob FORBIDDEN_PATTERNS（例如「禁子 repo 的 code 但放行 .md」
+#   這種細緻規則，glob 寫不出來，CC 的條件判斷寫得出來）。
+#   這個範本只對「不靠 CC、想自己手動 DIY bash」的用戶有價值。
+#
+# 要啟用（手動 DIY 路線）：
+#   1. 在下面 FORBIDDEN_PATTERNS 填禁改的路徑/檔名 pattern
+#   2. 到 .claude/settings.json 的 PreToolUse 加掛這支
+#
+# 掛在 PreToolUse（matcher: Write|Edit）。stdin 收 JSON：{ tool_name, tool_input:{ file_path } }
+# 命中禁令 → exit 2 擋。
+#
+# 誠實限制：只擋直接寫檔。bash 繞道、helper 間接改動擋不到。留痕可審 ≠ 技術防偽。
+
+set -euo pipefail
+
+# ── 專案自訂：禁改的 pattern（一行一個，case glob 語法）──────
+# 範例（已註解，啟用前請改成自己的）：
+#   "*/db/schema.sql"      # 禁手改 schema
+#   "*/migrations/*"        # migration 一旦建立不可改
+FORBIDDEN_PATTERNS=(
+  # "*/your/protected/path/*"
+)
+
+# 沒設任何禁令 → 空殼狀態，安靜放行。
+# （不在這裡 print——PreToolUse 每次 Write/Edit 都會跑，每次喊話會洗版。
+#  「這是空殼」的提醒改由 install.sh / update.sh 安裝時告知，那裡用戶一定看得到。）
+[ ${#FORBIDDEN_PATTERNS[@]} -eq 0 ] && exit 0
+
+INPUT=$(cat)
+
+if command -v jq >/dev/null 2>&1; then
+  FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
+else
+  FILE_PATH=$(printf '%s' "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//;s/"$//')
+fi
+
+[ -z "$FILE_PATH" ] && exit 0
+
+for pattern in "${FORBIDDEN_PATTERNS[@]}"; do
+  # shellcheck disable=SC2254
+  case "$FILE_PATH" in
+    $pattern)
+      cat >&2 <<EOF
+🚫 專案禁令攔截：$FILE_PATH 命中禁改規則（$pattern）。
+
+這是本專案 .claude/hooks/pre-write-guard.sh 設定的硬底線。
+要動 → 先和負責人確認，並更新禁令設定。
+EOF
+      exit 2
+      ;;
+  esac
+done
+
+exit 0

templatefs/.claude/hooks/publish-lag-check.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+# publish-lag-check.sh — SessionStart hook：偵測「公開 mirror 落後工作區」並出聲
+#
+# 病根（leo 2026-07-21 點名的真實風險）：
+#   Gitea（草稿/工作現場）與 GitHub（正稿/成品櫥窗）是**手動同步**的
+#   （靠人跑 scripts/publish-github.sh --push，且需 D20 arm）。
+#   → 改了零件、重編 wasm 後若沒人記得發佈，**用戶抓到舊版且沒有任何錯誤訊息，
+#     只是行為不對**——這種靜默失敗只有外部使用者會撞到，我們自己永遠測不到。
+#
+#   實例：安裝器的懶載會從
+#   cdn.jsdelivr.net/gh/youlinhsieh/Arcrun@main/.component-builds/<名>/component.wasm
+#   抓 wasm。那個位址永遠指向 GitHub 上的**最後一次發佈**，不是我們本機的最新版。
+#
+# 原理：比對「工作區 HEAD」與「.github-public 最後一個 release commit 記錄的 snapshot」。
+#   publish-github.sh 的 commit 訊息格式固定為：release: snapshot <短hash> (<日期>)
+#   → 從中取出 hash，看它是不是工作區 HEAD 的祖先／相同。
+#
+# 只提醒不阻擋（exit 0）：發不發佈是人的決定（且 push GitHub 需 leo 親跑 arm），
+#   hook 的職責只是消滅「忘了」這個失敗模式。
+set -euo pipefail
+
+MIRROR_DIR=".github-public"
+
+# 沒裝發佈管線的 repo 直接安靜退出
+[ -d "$MIRROR_DIR/.git" ] || exit 0
+[ -f "scripts/publish-github.sh" ] || exit 0
+git rev-parse --git-dir >/dev/null 2>&1 || exit 0
+
+HEAD_SHORT="$(git rev-parse --short HEAD 2>/dev/null || echo '')"
+[ -z "$HEAD_SHORT" ] && exit 0
+
+# 從 mirror 最後一個 commit 訊息取出它當初發佈的來源 hash
+LAST_MSG="$(git -C "$MIRROR_DIR" log -1 --format=%s 2>/dev/null || echo '')"
+PUBLISHED="$(printf '%s' "$LAST_MSG" | sed -n 's/.*snapshot \([0-9a-f]\{6,\}\).*/\1/p')"
+
+if [ -z "$PUBLISHED" ]; then
+  # mirror 存在但沒有可辨識的 release commit（可能還沒發過）
+  echo "════════════════════════════════════════════════"
+  echo "📦 這個 repo 有公開發佈管線，但 mirror 還沒發過任何版本"
+  echo "════════════════════════════════════════════════"
+  echo "   若已有用戶依賴公開版（例如安裝器從 jsDelivr 抓 wasm），現在是空的。"
+  echo "   發佈：leo 在頂層跑 scripts/github-arm.sh，再於本 repo 跑"
+  echo "         GITHUB_REMOTE=... bash scripts/publish-github.sh --push"
+  echo ""
+  exit 0
+fi
+
+# 已發佈的那個 commit 就是現在的 HEAD → 同步，安靜
+if [ "$PUBLISHED" = "$HEAD_SHORT" ]; then
+  exit 0
+fi
+
+# 算出落後幾個 commit（發佈點 → HEAD）。取不到就不顯示數字。
+BEHIND="$(git rev-list --count "${PUBLISHED}..HEAD" 2>/dev/null || echo '')"
+
+# 落後 0 且 hash 不同 → 可能是 mirror 比工作區新（罕見，例如剛 rebase），一樣提醒
+echo "════════════════════════════════════════════════"
+if [ -n "$BEHIND" ] && [ "$BEHIND" != "0" ]; then
+  printf '📤 公開 mirror 落後工作區 %s 個 commit（最後發佈：%s，現在：%s）\n' \
+    "$BEHIND" "$PUBLISHED" "$HEAD_SHORT"
+else
+  printf '📤 公開 mirror 與工作區不一致（最後發佈：%s，現在：%s）\n' "$PUBLISHED" "$HEAD_SHORT"
+fi
+echo "════════════════════════════════════════════════"
+echo "⚠️  外部使用者拿到的仍是舊版，而且**不會有任何錯誤訊息**——只是行為不對。"
+echo "   （安裝器的懶載直接從公開位址抓 wasm，落後＝裝到舊零件。）"
+echo ""
+echo "   要發佈：① leo 在頂層跑  bash scripts/github-arm.sh \"<任務描述>\" 30"
+echo "           ② 本 repo 跑    GITHUB_REMOTE=https://github.com/<帳號>/<repo>.git \\"
+echo "                            bash scripts/publish-github.sh --push"
+echo "   不急著發也沒關係——這只是提醒，別讓它靜默漏掉。"
+
+# 若這次落後的內容碰到 wasm，額外警告（那是用戶會直接抓的東西）
+if git diff --name-only "${PUBLISHED}..HEAD" 2>/dev/null | grep -q '\.wasm$'; then
+  echo ""
+  echo "   🔴 這批改動**包含 .wasm 變更** → 用戶抓到的零件會跟你本機不同，優先發佈。"
+fi
+echo ""
+
+exit 0

templatefs/.claude/hooks/sdd-guard.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+# PreToolUse hook — 動 code 前檢查 SDD ＋ 單一活性 SDD 鐵律（issue #6）
+# wishlist §2：把 /sdd-check 從「命令要人打」升級成「hook 自動攔」。
+# 生命週期規則全文：system-dev/docs/3-specs/SDD-LIFECYCLE.md
+#
+# 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。
+# stdin 收到 JSON：{ tool_name, tool_input: { file_path, ... } }
+# 行為：
+#   1. status: active 的 SDD > 1 份 → 單一活性鐵律已被違反，**不論寫什麼檔**一律擋（exit 2），
+#      先收斂到一份再說。
+#   2. 動 code 檔（.ts/.go/...）→ 需要「恰好 1 份」active SDD；0 份 → 擋。
+#   3. 向下相容：3-specs 下完全沒有任何 design.md 帶 frontmatter（老 repo 尚未遷移生命週期制度）
+#      → 退回舊行為：有 design.md 就放行＋提醒，沒有才擋。避免 template update 後老 repo 立刻全紅。
+#
+# 誠實限制（抄 arcrun）：只擋語法層明顯違規（直接寫 code 檔）。
+# 藏在 helper 裡、用 bash 繞道的改動擋不到。
+# 價值是「想跳過會被抓到 + 留痕可審」，不是技術防偽。絕不聲稱「不可能繞過」。
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# 解析 file_path。優先用 jq，沒有 jq 退回 grep（容錯）。
+if command -v jq >/dev/null 2>&1; then
+  FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
+else
+  FILE_PATH=$(printf '%s' "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//;s/"$//')
+fi
+
+# 拿不到路徑 → 不擋（容錯，寧可放過也不誤殺）
+[ -z "$FILE_PATH" ] && exit 0
+
+SPECS_DIR="system-dev/docs/3-specs"
+
+# ── 統計 active / frontmatter ──────────────────────
+# 排除 archive/（已封存）與 TEMPLATE（範本自帶 status: draft frontmatter，不算數——
+# 否則 update 一鋪新版 TEMPLATE-sdd，老 repo 就被誤判「已遷移」而全紅，向下相容破功）。
+# frontmatter 判定＝design.md 前 10 行有 ^status: 行（機器可查，見 SDD-LIFECYCLE.md）。
+ACTIVE_COUNT=0
+FM_COUNT=0
+ACTIVE_LIST=""
+if [ -d "$SPECS_DIR" ]; then
+  while IFS= read -r f; do
+    [ -n "$f" ] || continue
+    HEAD10=$(head -10 "$f" 2>/dev/null || true)
+    if printf '%s\n' "$HEAD10" | grep -q '^status:[[:space:]]*'; then
+      FM_COUNT=$((FM_COUNT + 1))
+      if printf '%s\n' "$HEAD10" | grep -q '^status:[[:space:]]*active'; then
+        ACTIVE_COUNT=$((ACTIVE_COUNT + 1))
+        ACTIVE_LIST="${ACTIVE_LIST}   • ${f}
+"
+      fi
+    fi
+  done < <(find "$SPECS_DIR" -name 'design.md' -not -path '*TEMPLATE*' -not -path '*/archive/*' 2>/dev/null)
+fi
+
+# ── 鐵律 1：單一活性被違反（active > 1）→ 不論寫什麼檔一律擋 ──
+if [ "$ACTIVE_COUNT" -gt 1 ]; then
+  cat >&2 <<EOF
+🚫 SDD 單一活性鐵律違反：偵測到 ${ACTIVE_COUNT} 份 status: active 的 SDD（任何時刻整個 repo 最多一份）：
+${ACTIVE_LIST}
+請先收斂到一份：其餘改 status: paused / closed（closed 且被取代者填 superseded_by 並移入 3-specs/archive/）。
+規則全文見 system-dev/docs/3-specs/SDD-LIFECYCLE.md。收斂前擋下所有寫檔。
+（本 hook 攔 Write/Edit；修 frontmatter 可用 bash 直改，或由人裁決哪份是現行。）
+EOF
+  exit 2
+fi
+
+# 只管 code 檔。docs/markdown/設定檔等放行。
+case "$FILE_PATH" in
+  *.ts|*.tsx|*.js|*.jsx|*.go|*.py|*.rs|*.java|*.rb|*.php|*.c|*.cpp|*.h|*.hpp|*.swift|*.kt) ;;
+  *) exit 0 ;;
+esac
+
+# 改 SDD 自己 / 測試檔 → 放行
+case "$FILE_PATH" in
+  *system-dev/docs/3-specs/*) exit 0 ;;
+  *_test.*|*.test.*|*.spec.*|*/tests/*|*/test/*) exit 0 ;;
+esac
+
+# ── 向下相容：整個 3-specs 沒有任何帶 frontmatter 的 design.md ──
+# ＝老 repo 還沒遷移生命週期制度 → 退回舊行為（有 design.md 就放行＋提醒），
+# 避免 template update 一裝新 hook，老 repo 所有 code 寫入立刻全紅。
+if [ "$FM_COUNT" -eq 0 ]; then
+  SDD_COUNT=0
+  if [ -d "$SPECS_DIR" ]; then
+    SDD_COUNT=$(find "$SPECS_DIR" -name 'design.md' -not -path '*TEMPLATE*' -not -path '*/archive/*' 2>/dev/null | wc -l | tr -d ' ')
+  fi
+
+  if [ "$SDD_COUNT" -eq 0 ]; then
+    cat >&2 <<EOF
+🚫 SDD 協議攔截：要動 code 檔 ($FILE_PATH)，但 ${SPECS_DIR}/ 下找不到任何 SDD。
+
+絕對鐵律：任何 code 變動前必須有對應 SDD（design.md），且遵守單一活性生命週期
+（system-dev/docs/3-specs/SDD-LIFECYCLE.md）。
+
+請先：
+  1. 確認這個改動屬於哪個子系統
+  2. 在 ${SPECS_DIR}/[子系統]/ 建立 design.md（可用 /sdd-check 協助），frontmatter 標 status: active
+  3. 在回覆開頭宣告已讀 SDD + 對應 task
+
+小修改（修 bug、改文字）若確定豁免，請明確說明範圍後由人放行。
+EOF
+    exit 2
+  fi
+
+  # 舊行為放行 + 提醒遷移（stderr 警告，不擋）
+  echo "📋 提醒：${SPECS_DIR}/ 有 SDD 但尚未掛生命週期 frontmatter（老結構）。動手前確認已讀對應 design.md；建議依 SDD-LIFECYCLE.md 補 status 標記（現行那份標 active）。" >&2
+  exit 0
+fi
+
+# ── 新行為：寫 code 檔需「恰好 1 份」active SDD ──
+if [ "$ACTIVE_COUNT" -eq 0 ]; then
+  cat >&2 <<EOF
+🚫 SDD 協議攔截：要動 code 檔 ($FILE_PATH)，但 ${SPECS_DIR}/ 下沒有任何 status: active 的 SDD。
+
+單一活性鐵律：所有開發任務唯一對應源＝那份 active SDD（規則見 system-dev/docs/3-specs/SDD-LIFECYCLE.md）。
+
+請先（擇一，都是人的決定，CC 不得自行建 SDD）：
+  1. 把現行規格的 design.md frontmatter 標成 status: active（一份、只能一份）
+  2. 或依 SDD-LIFECYCLE.md 第 3、4 條：proposal 進 pending-changes.md → 使用者 confirm → 開新 SDD 標 active
+然後在回覆開頭宣告已讀 active SDD + 對應 task。
+
+小修改（修 bug、改文字）若確定豁免，請明確說明範圍後由人放行。
+EOF
+  exit 2
+fi
+
+# 恰好 1 份 active：放行，留痕提醒要宣告（stderr 警告，不擋）
+printf '📋 提醒：現行 active SDD＝\n%s動手前請確認已讀它的 design.md、對應到 tasks，並在回覆宣告。\n' "$ACTIVE_LIST" >&2
+exit 0

templatefs/.claude/hooks/session-start-recall.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# SessionStart hook — 開 session 自動注入 status.md 重點
+# wishlist §1 主路徑：不靠 CC 自覺、不用人說，開 session 就把進度推到眼前。
+#
+# 掛在 settings.json 的 SessionStart（matcher: startup|resume|clear）。
+# stdout 會被當成 context 注入給 CC。
+#
+# 鐵律：status 是 point-in-time 快照，非即時狀態。
+# 這個 hook 只負責「把快照推到眼前」，核實快照是 CC 的責任——下面的提醒就是要它別盲信。
+
+set -euo pipefail
+
+STATUS_FILE="system-dev/wiki/status.md"
+PRINCIPLES_FILE="system-dev/wiki/principles.md"
+MISTAKES_FILE="system-dev/wiki/mistakes.md"
+
+# ── 舊結構防呆（1.9.0 遷移第 2 層保險）──
+# 新版 wiki 收進 system-dev/。若偵測到舊位置 .claude/wiki/ 還在、但新位置沒 status，
+# 代表使用者升級了規則卻沒跑遷移（low-code 使用者常見）→ 出聲提示，讓 CC 當場可代為遷移，
+# 不要默默用不到新結構而出錯。
+if [ -d ".claude/wiki" ] && [ ! -f "$STATUS_FILE" ]; then
+  echo "⚠️  偵測到舊版 wiki 結構（.claude/wiki/），尚未遷移到 system-dev/wiki/。"
+  echo "    請跑：bash system-dev/scripts/update.sh"
+  echo "    或直接叫我（CC）：「幫我把 wiki 遷移到 system-dev/」——我可以代為搬移。"
+  echo "    （未遷移時接關與 /wiki-init 會找錯位置。）"
+  exit 0
+fi
+
+# 三個 push 檔都沒有 → 安靜退出，不干擾還沒 /wiki-init 的專案
+if [ ! -f "$STATUS_FILE" ] && [ ! -f "$PRINCIPLES_FILE" ] && [ ! -f "$MISTAKES_FILE" ]; then
+  exit 0
+fi
+
+# ── push 1/3：principles（全文，行動前必服從）──
+# 放最前：原則是「會被遺忘的盲區」，要第一眼看見。全文成本低（一行一條、≤15 條）。
+if [ -f "$PRINCIPLES_FILE" ] && grep -q '^- ' "$PRINCIPLES_FILE" 2>/dev/null; then
+  echo "════════════════════════════════════════════════"
+  echo "📐 設計原則（行動前必服從，來自 principles.md）"
+  echo "════════════════════════════════════════════════"
+  grep '^- ' "$PRINCIPLES_FILE"   # 只注入原則條目本身，不含說明區
+  # context 保護：原則應 ≤15 條（push 全文）。超過 → 提示該合併或下放成 card，不截斷（截斷會漏原則）。
+  P_COUNT=$(grep -c '^- ' "$PRINCIPLES_FILE")
+  if [ "$P_COUNT" -gt 15 ]; then
+    echo ""
+    echo "（⚠️ principles 已 ${P_COUNT} 條 > 15：請考慮合併相近原則、或把較細的下放成 card）"
+  fi
+  echo ""
+fi
+
+# ── push 2/3：status（全文，當前進度）──
+if [ -f "$STATUS_FILE" ]; then
+  echo "════════════════════════════════════════════════"
+  echo "📍 接關：上次進度（來自 $STATUS_FILE 快照）"
+  echo "════════════════════════════════════════════════"
+  echo ""
+  cat "$STATUS_FILE"
+fi
+
+# ── push 3/3：mistakes（標題清單 + 一行症狀，全文按需展開）──
+# 不全文注入（可能累積很多、含長 context）。只給「標題行」讓 CC 認出「我正撞到某條」→ 再去讀全文。
+if [ -f "$MISTAKES_FILE" ] && grep -q 'MISTAKE' "$MISTAKES_FILE" 2>/dev/null; then
+  echo ""
+  echo "────────────────────────────────────────────────"
+  echo "⚠️  已知踩坑（標題；撞到時讀 $MISTAKES_FILE 全文）"
+  grep -E 'MISTAKE' "$MISTAKES_FILE" | sed 's/^/   /'
+fi
+
+echo ""
+echo "────────────────────────────────────────────────"
+echo "⚠️  以上是 point-in-time 快照，非即時狀態。"
+echo "    動手前先核實：快照寫的事項是否真的還沒做完？"
+echo "    需要完整脈絡（decisions / mistakes / SDD）→ 執行 /wiki-recall"
+echo "════════════════════════════════════════════════"
+
+# ── 遷移殘留偵測（1.9.x）：wiki 已搬到 system-dev/，但 CLAUDE.md 內容裡可能還寫舊路徑 ──
+# update.sh 鐵則「絕不碰 CLAUDE.md」（用戶資料），所以遷移不會自動改它內容裡的死引用。
+# 這裡只「偵測 + 提示 CC 代修」——由 CC（看得懂語義、不誤傷用戶自寫內容）來改，不讓腳本盲改。
+if [ -f "CLAUDE.md" ] && grep -q '\.claude/wiki' CLAUDE.md 2>/dev/null; then
+  echo ""
+  echo "🔧 偵測到 CLAUDE.md 內仍有舊路徑 \`.claude/wiki/\`（wiki 已遷移到 system-dev/wiki/）。"
+  echo "    這些是遷移後的死引用，會讓你（CC）找錯位置。"
+  echo "    請主動幫使用者把 CLAUDE.md 裡的 \`.claude/wiki/\` 改成 \`system-dev/wiki/\`、"
+  echo "    工具 docs 路徑改成 \`system-dev/docs/\`（但 raw source 宣告的 \`docs/\` 保留不動）。"
+fi
+
+exit 0

templatefs/.claude/hooks/subagent-wiki-guard.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# subagent-wiki-guard.sh — PreToolUse(Task) hook：subagent 聽到「查」就自己先查 wiki
+#
+# 病根（2026-07-20）：總管兩次派 agent 查 ENCRYPTION_KEY，prompt 都只叫它「去查 repo 程式碼」。
+#   agent 於是從**稿子**推論出「這東西還活著、不能動」，總管照單全收去擋 leo 三輪。
+#
+# 🔑 設計轉向（leo 2026-07-21）：
+#   第一版是「上游沒交代讀 wiki 就擋下」——但那**還是依賴上游記得寫**，
+#   跟「我記得讀 wiki」是同一個病。leo 點破：
+#     「subagent 的問題跟你一樣。你叫它去查，就算你沒說要先查 wiki，
+#       但它**只要聽到查，就應該主動查 wiki**，因為每個 repo 都有維護自己的 wiki。」
+#   → 改成 **注入式**：不擋、不要求上游改 prompt，直接把「先查 wiki」這條
+#     以 additionalContext 注入給 subagent，讓它自己做。零依賴任何人記得。
+#
+# 行為：偵測到查證/實作類任務 → exit 0 並用 hookSpecificOutput 注入指示。
+#       已含 wiki 指示、或非查證類任務 → 靜默放行（不重複注入）。
+set -euo pipefail
+
+INPUT=$(cat)
+
+PROMPT=$(printf '%s' "$INPUT" | python3 -c "
+import json,sys
+try:
+    d=json.load(sys.stdin)
+    print(d.get('tool_input',{}).get('prompt',''))
+except Exception: print('')
+" 2>/dev/null || echo "")
+
+[ -z "$PROMPT" ] && exit 0
+
+# 上游已經交代了 → 不必重複注入
+if printf '%s' "$PROMPT" | grep -qiE "wiki|agent-memory|mistakes\.md|decisions-summary"; then
+  exit 0
+fi
+
+# 只對「查證/實作」類任務注入（純寫作、計算、潤稿等不需要）
+if ! printf '%s' "$PROMPT" | grep -qiE "查|盤點|核實|確認|調查|研究|找出|repo|程式碼|原始碼|source|實作|移除|刪除|重構|修|grep|codebase|\.ts|\.go|src/"; then
+  exit 0
+fi
+
+python3 - <<'PY'
+import json
+
+guidance = """【自動注入：查任何東西之前，先查 wiki】
+
+你所在的 repo 有維護自己的 wiki（通常在 `system-dev/wiki/`，舊結構在 `.claude/wiki/`）。
+**接到「查／盤點／核實／實作」類任務時，第一個動作是搜尋 wiki，不是翻程式碼。**
+
+🔴 **查法有強弱之分，一律從最強的開始——沒有那個能力才降級。**
+（leo 2026-07-21：「它一定是用最好的搜尋，如果沒有才 fallback，
+  但那不是你要指定的，對搜尋者來說，我就是要去搜尋，如果你沒這個機制才降。」）
+
+  **① 語意搜尋（最強，優先）**——有 Arcrun RAG MCP 就用它，用**自然語言問句**，不是關鍵字：
+       kbdb_search(q="<用一句話描述你要找什麼>", mode="semantic")
+       不確定該查哪個庫 → 先 kbdb_get_map() 看藏書地圖
+       要沿關係展開 → kbdb_graph_neighbors()
+  **② 關鍵字搜尋**——語意不可用時：kbdb_search(q="...", mode="keyword")
+  **③ grep（最弱，最後手段）**——連 MCP 都沒有時：
+       grep -rin "<關鍵字>" system-dev/wiki/ 2>/dev/null || grep -rin "<關鍵字>" .claude/wiki/
+
+🔴 **為什麼順序是硬規定（2026-07-21 實際事故）**：
+   查「CF 上的 git 託管」時只用了 grep，搜 Gitea/freeze/D43 等字面詞 → **零命中**，
+   結論寫成「這件事沒查過、申請表沒送」。
+   事後用**同一個問題**跑語意搜尋，**第一筆就命中**（score 0.858）：
+   「Cloudflare Artifacts：假設內建 git 倉庫機制的 CF 功能，成立則可全 CF 化」，
+   還帶出三元組「Cloudflare Artifacts >> 若提供 git 倉庫則可取代 >> Gitea」——
+   **負責人 15 天前就記在筆記裡了。**
+   → **grep 只認字面，要求你先猜對那個詞；語意搜尋不需要你猜對。**
+     用 grep 查不到 ≠ wiki 沒記載，只代表你沒猜中用詞。
+
+🔴 **凡結論涉及「某人沒做某事」，回報前必須先用語意搜尋查該事的記載**——
+   這種結論錯了會變成**指控**，成本遠高於技術判斷錯誤。
+
+為什麼這是划算的：
+  • wiki 是前人已經查過、驗證過、被負責人糾正過的結論——**判準**。
+  • 程式碼與歷史文件是**稿子**：它反映「還沒清乾淨」，不等於「還在用」。
+    從稿子推論會系統性得出過時結論。
+  • wiki 沒記載，才值得花力氣翻原文。
+  • **凡結論涉及「某人沒做某事」，回報前必須先 grep 該事在 wiki 的記載**——
+    這種結論錯了會變成指控，成本遠高於技術判斷錯誤。
+
+三條硬規則：
+  1. **wiki 與程式碼衝突 → 以 wiki 為準**，並在回報中明確指出衝突，
+     不要自行用 code 推翻 wiki。
+  2. wiki 寫「不可動／待廢除／進行中」→ **讀它的解除條件並逐條核對**。
+     那是當時狀態，不是永久禁令；條件已滿足就是可動。
+     （2026-07-20 實際事故：agent 只看到「不可動」就回報不能動，
+       實際上解除條件早已滿足，害負責人被擋三輪。）
+  3. 翻原文後若得到**新結論**，回報時明講「wiki 該更新」——wiki 過時是債，要還。
+"""
+
+print(json.dumps({
+    "hookSpecificOutput": {
+        "hookEventName": "PreToolUse",
+        "additionalContext": guidance
+    }
+}, ensure_ascii=False))
+PY
+
+exit 0

templatefs/.claude/hooks/wiki-first-search.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+# wiki-first-search.sh — PreToolUse hook：要去翻原文/程式碼前，先把 wiki 命中結果推到眼前
+#
+# 病根（2026-07-20 leo 點破，mistakes 第一鐵律）：
+#   總管 session 開頭讀了 agent-memory 前 50 行就開工，關鍵那條在第 56 行 → 拿過期記憶擋了 leo 三輪。
+#   leo：「如果你不是讀而是**搜尋** wiki 就不會只讀 50 行就下定論，
+#         而是就像我直接在頁面 cmd+F，那些都會高亮。」
+#
+# 設計要點（為什麼是這個形狀）：
+#   1. **搜尋 ≠ 通讀**：開場 push 全文（session-start-recall.sh）解決不了這題——量大必然只讀開頭。
+#      這支反過來：在「你正要去查 code/原文」的當下，用你自己的關鍵字 grep wiki，只推命中行。
+#   2. **時機是關鍵**：不是開場推、不是寫入時擋，而是**查詢動作發生的那一刻**介入。
+#   3. **提醒不阻擋**（exit 0）：wiki 沒記載時本來就該去翻原文，擋下來反而礙事。
+#      唯一目的是消滅「不知道 wiki 有寫」這件事。
+#
+# 觸發：Grep / Glob / Read 打向 code 或 docs 時（見下方 should_check）。
+# 輸出：stdout 注入 context（命中的 wiki 行 + 檔名:行號）。
+set -euo pipefail
+
+INPUT=$(cat)
+TOOL=$(printf '%s' "$INPUT" | python3 -c "import json,sys;print(json.load(sys.stdin).get('tool_name',''))" 2>/dev/null || echo "")
+
+# 取出這次查詢的關鍵字：Grep 用 pattern，Glob/Read 用路徑的檔名部分
+QUERY=$(printf '%s' "$INPUT" | python3 -c "
+import json,sys,os,re
+try:
+    d=json.load(sys.stdin); ti=d.get('tool_input',{})
+    q = ti.get('pattern') or ''
+    if not q:
+        p = ti.get('file_path') or ti.get('path') or ''
+        q = os.path.splitext(os.path.basename(p))[0] if p else ''
+    if not q:
+        # Bash：2026-07-21 補的破口——原版只掛 Grep|Glob|Read，
+        # 但「用 curl/wrangler 亂試部署方法」走的是 Bash，整支 hook 不觸發。
+        # leo 當場點破：wiki 早記著「寄信已驗證可用」，我卻沒查又自創方法。
+        # 只認「會動到外部系統/部署」的高風險指令，避免每個 ls 都洗版。
+        cmd = ti.get('command') or ''
+        if re.search(r'\b(wrangler|curl|npx|acr|gh|deploy|push)\b', cmd):
+            # 取指令中最具識別度的詞（worker 名/資源名/子命令）當搜尋詞
+            cand = re.findall(r'[A-Za-z_][A-Za-z0-9_-]{4,}', cmd)
+            skip = {'https','http','client','accounts','workers','scripts',
+                    'application','content','Authorization','Bearer','python3',
+                    'curl','npx','bash','echo','grep','local','branch','origin'}
+            cand = [c for c in cand if c not in skip and not c.startswith('-')]
+            q = max(cand, key=len) if cand else ''
+    # grep pattern 常含 regex 元字元；取最長的英數/底線詞當搜尋詞
+    words = re.findall(r'[A-Za-z_][A-Za-z0-9_]{3,}', q)
+    print(max(words, key=len) if words else '')
+except Exception:
+    print('')
+" 2>/dev/null || echo "")
+
+[ -z "$QUERY" ] && exit 0
+
+WIKI_DIR="system-dev/wiki"
+[ -d "$WIKI_DIR" ] || exit 0
+
+# 只在「查程式碼/文件」時提醒；查 wiki 本身就不用了（已經在讀了）
+TARGET=$(printf '%s' "$INPUT" | python3 -c "
+import json,sys
+try:
+    d=json.load(sys.stdin); ti=d.get('tool_input',{})
+    print(ti.get('file_path') or ti.get('path') or '')
+except Exception: print('')
+" 2>/dev/null || echo "")
+case "$TARGET" in
+  *system-dev/wiki*) exit 0 ;;
+esac
+
+# grep wiki（不分大小寫、含行號），最多 12 行避免洗版
+HITS=$(grep -rin --include="*.md" -- "$QUERY" "$WIKI_DIR" 2>/dev/null | head -12 || true)
+
+# 🔴 grep 零命中時**不能靜默退出**——那正是今天失敗的模式（2026-07-21）：
+#    grep 查不到 → 以為 wiki 沒記載 → 結論「這件事沒查過」。
+#    但 grep 只認字面，查不到往往只代表「沒猜中用詞」。
+#    → 零命中反而是**最該改用語意搜尋**的時刻，必須出聲。
+if [ -z "$HITS" ]; then
+  echo "════════════════════════════════════════════════"
+  printf '🔍 grep 在 wiki 找不到「%s」——但這**不代表沒記載**\n' "$QUERY"
+  echo "════════════════════════════════════════════════"
+  echo "grep 只認字面，查不到通常只是「沒猜中用詞」。**改用語意搜尋再確認一次**："
+  echo "   kbdb_search(q=\"<用一句話描述你要找什麼>\", mode=\"semantic\")"
+  echo "   不知道該查哪個庫 → kbdb_get_map()｜要沿關係展開 → kbdb_graph_neighbors()"
+  echo ""
+  echo "實例：查「CF 上的 git 託管」時 grep 全零命中，語意搜尋第一筆就命中"
+  echo "（Cloudflare Artifacts >> 若提供 git 倉庫則可取代 >> Gitea，負責人 15 天前就記了）。"
+  echo ""
+  exit 0
+fi
+
+COUNT=$(printf '%s\n' "$HITS" | wc -l | tr -d ' ')
+
+echo "════════════════════════════════════════════════"
+printf '📚 wiki 已有「%s」的記載（%s 處，先看這裡再翻原文）\n' "$QUERY" "$COUNT"
+echo "════════════════════════════════════════════════"
+printf '%s\n' "$HITS" | sed 's|^system-dev/wiki/|  |'
+echo ""
+echo "⚠️  wiki 是判準，程式碼與歷史文件只是稿子（mistakes 第一鐵律）。"
+echo "   • 上面若與你將要查的原文衝突 → **以 wiki 為準**，別用 code 推翻 wiki。"
+echo "   • 看到「不可動／待廢除／進行中」→ 先讀它的**解除條件**並逐條核對，"
+echo "     那是當時狀態不是永久禁令；條件已滿足就是可動。"
+echo "   • wiki 沒答案才值得翻原文——翻完若得到新結論，**回頭更新 wiki**。"
+echo ""
+echo "🔎 以上是 **grep（最弱的查法）** 的結果，只認字面，且搜尋詞是從你的指令**猜**出來的"
+echo "   （很可能太籠統而命中一堆無關的，同時漏掉真正的主題詞）。"
+echo "   **重要判斷一律補一次語意搜尋**——它不需要你猜對用詞："
+echo "      kbdb_search(q=\"<一句話描述你要找什麼>\", mode=\"semantic\")"
+echo "   實例：查「CF 的 git 託管」時 grep 猜到的詞是 cloudflare → 命中 12 處全無關、"
+echo "   真正的答案（Artifacts）一筆沒撈到；語意搜尋第一筆就命中。"
+echo ""
+
+exit 0

templatefs/.claude/hooks/wiki-secret-scan.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+# PreToolUse hook — 寫入 wiki 前掃機敏資訊（L3 硬攔截）
+#
+# 為什麼存在：wiki 的 ignore 規則（.wikiignore + 行內標記）是「協議層」，靠 CC 遵守。
+# 但密碼/金鑰/個資外洩是「不可逆」後果——只靠口頭約束太危險。
+# 這支 hook 是機械式底線：CC 真的把機敏資訊寫進 system-dev/wiki/ 的那一刻 → exit 2 擋下。
+#
+# 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。
+# stdin 收到 JSON：{ tool_name, tool_input: { file_path, content?, new_string? } }
+# 行為：只在目標路徑是 system-dev/wiki/** 時啟動，掃要寫入的內容，命中機敏特徵 → exit 2。
+#
+# 誠實限制（抄 sdd-guard）：regex 偵測有偽陰/偽陽。
+# 擋的是「明顯特徵的機敏字串被自動抄進 wiki」，擋不了刻意混淆/編碼的繞道。
+# 價值是「意外外洩的機械底線 + 留痕可審」，不是技術防偽。絕不聲稱「不可能繞過」。
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# ── 解析 file_path 與要寫入的內容。優先 jq，無 jq 退回 grep（容錯）──────
+if command -v jq >/dev/null 2>&1; then
+  FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty')
+  # Write 用 content；Edit 用 new_string。兩個都抓，合起來掃。
+  CONTENT=$(printf '%s' "$INPUT" | jq -r '[.tool_input.content, .tool_input.new_string] | map(select(. != null)) | join("\n")')
+else
+  FILE_PATH=$(printf '%s' "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//;s/"$//')
+  # 無 jq 時內容解析不可靠（JSON 跳脫），退回掃整包 INPUT，寧可多掃不漏掃
+  CONTENT="$INPUT"
+fi
+
+# 拿不到路徑 → 不擋（容錯，寧可放過也不誤殺）
+[ -z "$FILE_PATH" ] && exit 0
+
+# 只管寫進 wiki 的動作。其他路徑放行（這支專責 wiki 洩漏，不是全域 secret scanner）
+case "$FILE_PATH" in
+  *system-dev/wiki/*) ;;
+  *) exit 0 ;;
+esac
+
+[ -z "$CONTENT" ] && exit 0
+
+# 行內豁免：若該段內容已被標記為刻意保留（例：範例文件要示範格式），略過該行
+# 標記：行尾加  # wiki-secret-ok  （或 <!-- wiki-secret-ok -->）
+# 先把標記過的行抽掉再掃。
+SCAN=$(printf '%s' "$CONTENT" | grep -v -E 'wiki-secret-ok' || true)
+[ -z "$SCAN" ] && exit 0
+
+# ── 機敏特徵 pattern。一行一類，命中即攔。──────────────────────────
+# 設計取捨：偏向高訊號 pattern（有明確結構的金鑰/標記），降低偽陽。
+# 純「password=xxx」這類也納入，因為那正是使用者最擔心的場景。
+HITS=""
+
+check() {
+  local label="$1" regex="$2"
+  # -e 讓以 - 開頭的 pattern（如 PEM 的 -----BEGIN）不被當成選項。
+  # grep 無命中回傳 1，在 set -e 下會中止 → 用 if 包住吸收掉。
+  if printf '%s' "$SCAN" | grep -qiE -e "$regex"; then
+    HITS="${HITS}
+   • ${label}"
+  fi
+}
+
+# 密碼/密鑰賦值（password = ..., secret: ..., api_key=...）
+check "密碼/密鑰賦值 (password/secret/api_key/token = ...)" \
+  '(pass(word)?|secret|api[_-]?key|access[_-]?key|auth[_-]?token|priv(ate)?[_-]?key)[[:space:]]*[:=][[:space:]]*[^[:space:]<>"'"'"']{6,}'
+
+# 私鑰 PEM 區塊
+check "私鑰檔內容 (BEGIN ... PRIVATE KEY)" \
+  '-----BEGIN[[:space:]].*PRIVATE KEY-----'
+
+# 常見雲端/服務金鑰前綴
+check "服務金鑰特徵 (AWS/GitHub/Slack/Google/Stripe 等)" \
+  '(AKIA[0-9A-Z]{16}|gh[pousr]_[0-9A-Za-z]{20,}|xox[baprs]-[0-9A-Za-z-]{10,}|AIza[0-9A-Za-z_-]{20,}|sk_(live|test)_[0-9A-Za-z]{16,})'
+
+# JWT
+check "JWT token" \
+  'eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}'
+
+# 連線字串內嵌帳密 (proto://user:pass@host)
+check "連線字串內嵌帳密 (proto://user:pass@host)" \
+  '[a-z][a-z0-9+.-]*://[^[:space:]:/@]+:[^[:space:]:/@]+@'
+
+# 台灣身分證字號（個資）。BSD/GNU grep 都支援 ERE，避免 \b（BSD 不認），改用字元類邊界。
+check "台灣身分證字號 (個資)" \
+  '(^|[^A-Za-z0-9])[A-Z][12][0-9]{8}([^0-9]|$)'
+
+# 信用卡號（個資，粗略 13-16 連續數字，可含空格/連字號分隔）。避免 PCRE，用 ERE 近似。
+check "疑似信用卡號 (個資)" \
+  '(^|[^0-9])[0-9]{4}[ -]?[0-9]{4}[ -]?[0-9]{4}[ -]?[0-9]{0,4}([^0-9]|$)'
+
+# Email 不擋（wiki 常需記聯絡人），手機號也不擋（偽陽太高）——刻意留白。
+
+if [ -n "$HITS" ]; then
+  cat >&2 <<EOF
+🚫 Wiki 機敏攔截：偵測到可能的機敏資訊要寫進 ${FILE_PATH}。
+
+命中特徵：${HITS}
+
+wiki 是會被 CC 反覆讀取、可能進版控的記憶空間。
+密碼 / 金鑰 / 個資寫進去 = 不可逆外洩風險。
+
+請改成下列任一做法：
+  1. 不要把機敏值寫進 wiki，改記「位置」（例：「DB 密碼放 1Password / .env，不入 wiki」）
+  2. 確定是誤判（例：在示範格式）→ 該行尾加註記  wiki-secret-ok  後重寫
+  3. 整個來源檔本就機敏 → 加進 system-dev/wiki/.wikiignore，別讓它被編入
+
+誠實限制：本掃描靠特徵比對，有偽陽/偽陰，是「意外外洩的機械底線」而非保險箱。
+真正的密鑰本就不該進版控。
+EOF
+  exit 2
+fi
+
+exit 0

templatefs/.claude/settings.json

@@ -0,0 +1,61 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/session-start-recall.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "startup|resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/publish-lag-check.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/sdd-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": ".claude/hooks/pre-write-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": ".claude/hooks/wiki-secret-scan.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Grep|Glob|Read|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/wiki-first-search.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/subagent-wiki-guard.sh"
+          }
+        ]
+      }
+    ]
+  }
+}