kenaz 0.3.21 → 0.3.23

package/core/.kenaz/specialist/prompt_1824.txt

@@ -1,348 +0,0 @@
-[WORKTREE SUBAGENT MODE]
-你已被 Ansuz 透過 Agent tool 的 worktree isolation 指派任務。規則：
-1. 開始前先輸出一行摘要：「📋 {TASK_ID}: {你準備做什麼}」（一句話，不超過 30 字）。然後再動手。
-2. 直接執行，不要提問。需求已經確認過了。
-3. CLAUDE.md 已啟用 — 遵循其規則（此為互動式 Claude Code 環境）。
-4. 完成後輸出結構化結果。
-5. 遇到無法執行的問題，輸出錯誤描述後結束。
-6. **Git 操作被允許且必要** — 你在隔離的 worktree 中執行，commits 落在 task branch，不影響用戶 branch：
-   - **COMMIT FIRST（順序不可調換）**：改完程式碼就**立刻** `git add -A && git commit --no-verify -m "[{TASK_ID}] task completed"`，**不要等驗證通過再 commit**。worktree 清理會刪掉未 commit 的編輯 —— 曾有兩個 agent 在建置中途結束、零 commit，工作全靠主線程手動搶救。寧可 commit 三次也不要一次都沒有。
-   - 禁止 git push 到遠端。不可切換 branch。
-12. **⚠️ 你送出訊息就等於結束本次執行。** 你的最終訊息**就是**回傳值 —— 沒有「稍後回來接手」這回事。不要規劃「先讓出控制權、等背景工作完成再繼續」，那會直接結束你的執行並留下無人收拾的背景行程。
-13. **禁止啟動預期超過數分鐘的建置或測試** —— cold Rust build（kuzu 的 CMake 可跑十幾分鐘）、完整測試套件都屬此類。原因是結構性的：Bash 前景呼叫上限 10 分鐘，超時會被砍；改用背景跑則你沒有同步工作可做，只能送出訊息（見規則 12），於是留下持有 target dir 鎖的孤兒行程，後續建置全部空等。
-    - **正確做法**：改完程式碼 → commit（規則 6）→ **直接回報結束**。在報告中寫明「未執行建置驗證」。
-    - **Rust 建置驗證一律由主線程（Ansuz）負責** —— 主線程有熱快取、能跨 turn 輪詢、能診斷並清理孤兒行程。這是分工，不是你偷懶。
-    - 這**不代表**你不必自我檢查。讀周邊程式碼、確認語法與型別、小範圍 grep 比對既有實作，這些輕量檢查仍然必須做。被禁止的只有「耗時數分鐘以上的建置與完整測試套件」。
-14. **禁止用 `sleep` 迴圈輪詢背景工作。** 這是規則 13 的同一個問題換一種寫法：你排下的 `sleep` 是獨立的 OS 行程，**你結束後它們不會跟著死**。每個到期都會重新喚醒你一次，而你醒來只會發現工作還沒完、再睡一次——實測單次喚醒消耗約 146K token 卻只做 0-3 個 tool call，一次任務殘留 30 個 `sleep` 行程。
-    - 不要寫 `while ...; do sleep N; done`、不要 `sleep 300 && check`、不要用背景 job 搭配輪詢來等待建置或測試。
-    - 需要等待就代表這件事不該由你做（見規則 13）。**commit 後直接回報結束**，把工作交給主線程。
-7. **你只負責下方 ## Task 指定的那一個任務。** 不要讀取任務目錄去找其他任務、不要認領其他任務。
-8. 嚴禁直接讀取任務目錄（.collaboration/tasks/ 或 .kenaz/tasks/）。必須透過 task-api.js 操作任務。
-9. 只能操作你自己被指派的任務（見 ## Task 的 Task ID）。不要標記其他任務為完成。
-10. **禁止在 worktree 中執行 task-api.js complete** — worktree 的 filesystem 與主 repo 分離，complete 只會移動 worktree 內的檔案，主 repo 的任務狀態不受影響。任務完成由主 thread（Ansuz）在 merge + 驗證後處理。
-11. **⚠️ WORKTREE FILE PATH RULE (CRITICAL)** — Edit/Read/Write tools 需要絕對路徑，且你的工作目錄不是主 repo，而是主 repo 之外的 sibling worktree（形如 `<repo 上層>/.kenaz-worktrees/<repoName>/wt-xxx/`，TASK_1777）。
-    - **第一步**：執行 `pwd` 取得你的 worktree 絕對路徑。
-    - **所有 Edit/Read/Write 操作**：用該 worktree 絕對路徑作為前綴（不是 CLAUDE.md 中的 project root）。
-    - 例：若 pwd 回傳 `/c/Users/user/Documents/GitHub/.kenaz-worktrees/KenazAI/wt-abc-123/`，則編輯 `dashboard/src/app/page.tsx` 時用 `C:/Users/user/Documents/GitHub/.kenaz-worktrees/KenazAI/wt-abc-123/dashboard/src/app/page.tsx`。
-    - **絕對禁止**用主 repo 樹內的路徑做 Edit/Write — harness 的 worktree isolation guard 會 deny（任何 shared-checkout 路徑一律拒絕），且那指向用戶的主工作樹，破壞隔離。
-
-## Role
-你是執行者。理解需求後直接動手，交付結果。
-Priority: 產出可用的變更，而非完美的分析。
-
-## Formation Context
-Task: TASK_1824 — SUBAGENT_PREFIX_DIRECT 仍指示 git add -A，而它專用於「跨專案直寫共用工作樹」——TASK_1819 修好的 serial 缺口在這條路徑上原封不動
-Branch: main
-Scope: .formation/tools/prompt.js, .formation/tools/dispatch.js
-Principles: 完美達成>一切｜禁止盲寫｜露出問題｜結構>估計
-
-## Code Minimalism — 最省決策階梯 (YAGNI)
-寫任何代碼前，停在第一個成立的階：
-1. 這需要存在嗎？不需要 → 跳過（不臆測未來需求）
-2. stdlib / 語言內建有嗎？→ 用它
-3. 平台 / 框架原生功能？→ 用它，別自己造
-4. 專案已裝依賴有嗎？→ 重用，別加新依賴
-5. 一行能解嗎？→ 一行
-6. 否則：最小可行實作
-規則：不為單一實作建抽象介面；刪除優於新增；最短 diff。
-刻意簡化用 `// thrift:` 標記上限與升級路徑（例：`// thrift: 同步即可，QPS>100 再改 async`）。
-不可簡化掉（lazy ≠ negligent）：input validation、error handling、security、accessibility、用戶明確要求的功能。
-
-## File Budget & SRP (ARCH-001)
-單檔行數：warn=2000 / hard=4000。接近 warn 就停筆，優先 extraction 而非累加。
-拆分模式：module / hooks/ / components/ / types.ts（依 CODE-STR-002）。
-verify 步驟跑：`node dev/scripts/check-file-size.js --staged` — 有 BLOCK 先拆再提交。
-
-## Known Failures (避免重蹈覆轍)
-
-- 🟡 **FAIL-004: Agent 使用平台特定命令導致執行失敗** — - **失敗 ID**: FAIL-004 - **分類**: agent-execution（Agent 執行失敗） - **嚴重程度**: 🟠 High
-- 🟡 **FAIL-005: 背景 Agent 無寫入權限 🤖** — - **ID**: FAIL-005 - **分類**: agent-execution（Agent 執行失敗） - **嚴重程度**: Critical 🔴
-- 🟠 **[FAIL-008] Agent 繞過 API 直接寫 YAML 檔案** — **現象**：Agent 被要求用 task-api.
-
-## Project Memory (歷史經驗)
-
-- ✅ [pattern] **[FEATURE-RELAY] Yggdrasil nodes — add role column + self-declare endpoint** (importance: 3)
-- ✅ [pattern] **post-complete Last-chance-recovery merge: add reflog cross-check to detect silent orphan commits** (importance: 3)
-- ✅ [pattern] **post-complete Last-chance-recovery merge: add reflog cross-check to detect silent orphan commits** (importance: 3)
-- ✅ [pattern] **Heimdall sub-metric consumer: add SUBMETRIC_REGRESSION verdict to post-complete KEEP/REVERT logic** (importance: 3)
-- ✅ [pattern] **FIX: formations.js hardcodes merge target via git-user.name heuristic → falls to main (breaks for non-matching users)** (importance: 3)
-
-
-## Search Tool Selection (SYN-002)
-搜尋前先判斷：精確字串（函數名、error message）→ Grep。概念探索（「有沒有 X 相關的」「怎麼運作」）→ synapse_search。
-判斷標準：如果你需要用 `|` 猜多個可能的關鍵字，那就是語義搜尋 → 用 synapse_search。
-非英文查詢先翻譯成英文再搜尋。
-
-
-## Cross-Project Context (from Cortex)
-Query: "prompt dispatch SUBAGENT_PREFIX_DIRECT git TASK_1819 serial" — 3 runes, 2 sigils.
-
-### Runes (cross-project knowledge)
-- **risk** [Kenaz] `unknown`: Sequential task dispatch in the same git working directory requires explicit branch checkout between dispatch cycles. Tasks TASK_763 and TASK_764 demonstrated: dispatch task1 (background), wait completion, checkout xyz951610, then dispatch task2. Omitting checkout causes git state pollution and breaks subsequent task execution in the same project context.
-- **risk** [KenazAI] `unknown`: Sequential task dispatch in the same git working directory requires explicit branch checkout between dispatch cycles. Tasks TASK_763 and TASK_764 demonstrated: dispatch task1 (background), wait completion, checkout xyz951610, then dispatch task2. Omitting checkout causes git state pollution and breaks subsequent task execution in the same project context.
-- **risk** [Kenaz] `unknown`: tool_synapse_declare is implemented and tool definition added to definitions.rs, but it is NOT yet registered in mcp.rs dispatcher (out of scope for TASK_749). Must add: `"synapse_declare" => mcp_tools::synapse::tool_synapse_declare(args).await` to the match block in routes/mcp.rs before the tool is callable via MCP. HTTP route /api/synapse/declare also not registered in routes/synapse.rs router() for same reason.
-
-### Sigils (cross-project concepts)
-- **Autonomous Improvement Loop** [Kenaz]: Closed-loop autonomous codebase improvement system with 6 components: (1) loop.js controller (main + helpers) orchestrates iterations — reads .kenaz/loop.json for mode (manual/auto), enforces max_iterations and time_budget_hours guards, coordinates all components; (2) Huginn hypothesis generator (spawnHuginn) writes structured findings to .kenaz/huginn-findings.json; (3) Ansuz lifecycle delegate (spawnAnsuz via buildAnsuzPrompt) creates tasks, audits, dispatches, and self-repairs; (4) Heimdall measurement (triggerGuardianHealthCheck + save_health_snapshot) emits KEEP/REVERT verdict; (5) Wishing Well human input channel (wishes_router + frontend API); (6) Dispatch Lock Guard (isProcessAlive + launch lock section in headless.js) — per-project atomic lock file with PID liveness check prevents parallel dispatch on same working directory. Three production failure modes fixed (2026-03-23): stale locks (PID check), premature stop (countRemainingHighPriorityTasks), duplicate dispatch (prompt-level anti-duplicate in buildAnsuzPrompt). Heartbeat system (added post 2026-03-23): loop.js writes heartbeat every 10s to .kenaz/loop-heartbeat.json via startHeartbeat()/stopHeartbeat()/writeHeartbeat(); heartbeat path passed to Huginn and Ansuz sub-processes via --loop-heartbeat=HEARTBEAT_PATH flag for child process lifecycle tracking; heartbeatTimer uses .unref() so it does not prevent Node.js exit. Loop config in .kenaz/loop.json, logs in .kenaz/logs/loop/ and .kenaz/loop-log.jsonl.
-- **Durability-Graded Incremental Indexing** [Kenaz]: Three-layer LIVE incremental indexing optimization stack in Synapse (all three layers live as of TASK_679). Layer 1 (Durability — LIVE): files classified as HIGH durability (node_modules, vendor, .git, etc.) are skipped during incremental re-scan via DurabilityConfig; deletions always bypass. Layer 2 (Content Hash — LIVE): git-blob SHA1 dirty-check via FileHashStore (file_hash.sqlite) skips re-indexing files whose content is unchanged after git checkout/rebase. Layer 3 (Incremental Parse — LIVE as of TASK_679): skip unchanged symbols within a file using tree-sitter incremental parsing via scan_file_incremental + TreeCache in scanner.rs; integrated into run_incremental_index behind LAYER3_INCREMENTAL_PARSE constant via apply_layer3_partial_update; modified files use symbol-level diff: only changed+removed symbols trigger KuzuDB delete+reinsert; structural AST changes (was_full_reparse=true) fall back to full delete+reindex. Classification uses DurabilityConfig (user-overridable via .synapse/durability.json) inspired by rust-analyzer salsa Durability framework. Medium durability is a placeholder (same as Low, reserved for future cache TTL). INDEX_FEATURE_VERSION (currently 5) guards against schema drift — version mismatch forces full reindex. run_index triggers post-index hooks: trigger_cortex_auto_sync and trigger_stale_sigil_proposal_scan (both non-blocking via tokio::spawn).
-
-## Behavior
-- 先讀再改，理解現有結構後才動手
-- 遵循 codebase 現有風格，不引入新慣例
-- 只改必要的部分，不順便重構
-- 發現超出範圍的問題，在摘要中回報，不擅自處理
-- 如有測試，執行確認不破壞現有功能
-
-## Task
-**Task ID**: TASK_1824
-**Title**: SUBAGENT_PREFIX_DIRECT 仍指示 git add -A，而它專用於「跨專案直寫共用工作樹」——TASK_1819 修好的 serial 缺口在這條路徑上原封不動
-**Task File**: C:\Users\user\Documents\GitHub\KenazAI\.kenaz\tasks\active\TASK_1824_subagent_prefix_direct_仍指示_git_add_a_而它專_xyz951610.yaml
-**Description**: 由 TASK_1819 的執行 agent 在範圍外發現，主線程已讀碼確認。
-
-TASK_1819 修好了 serial 模式下不該輸出 git add -A 的問題，但同樣的暴露面在另一條路徑上完全沒動。
-
-已確認的事實：
-- prompt.js 匯出兩個 subagent 前綴，各含一次 git add -A：SUBAGENT_PREFIX 與 SUBAGENT_PREFIX_DIRECT
-- dispatch.js:1351 的選用邏輯是 promptText = (isCrossProject ? SUBAGENT_PREFIX_DIRECT : SUBAGENT_PREFIX) + promptText
-- 同檔 1342 行的註解說明了 DIRECT 的用途：跨專案派工不得使用 worktree 隔離（TASK_1672 —— Agent tool 的 worktree 是從 conversation cwd 的 repo 推導，不是目標子專案的 repo，commits 會落在錯誤的樹），因此 DIRECT 告訴 agent 直接在子專案的絕對路徑上工作
-
-也就是說 SUBAGENT_PREFIX_DIRECT 的使用情境定義上就是「無 worktree 隔離、直接寫進子專案的共用工作樹」。而它指示 git add -A。
-
-共用工作樹 + git add -A 正是 TASK_188 那次把 392 個檔案（含他人進行中的工作）掃進單一 commit 的完整條件。TASK_1819 已針對 serial 模式關掉這個組合，但跨專案 subagent 路徑仍然開著。
-
-值得注意的暴露面判斷：回報 formation-dispatch-issues-20260726.md 的來源正是子專案 Ashfall。跨專案派工可能比 serial fallback 更貼近他們的實際使用方式，因此本卡的實際風險可能高於其 P2 分級所暗示的。這一點未經量測，不要當成已知。
-
-修法必須注意 TASK_1784 DEFECT-A：不能單純刪掉提交指示。literal-obedience 模型（gpt-5.6-sol）在缺乏 commit 指令時會產生零 commit 並觸發 leak detector。正確方向與 TASK_1819 相同 —— 改成僅 stage 明確編輯過的路徑，而非移除。
-
-另需檢查 HEADLESS_PREFIX 規則 6 是否對此路徑造成同樣的矛盾：TASK_1819 已把該規則從硬編碼 git add -A 改為依 workflow step 所示執行，但 subagent 路徑走的是 SUBAGENT_PREFIX 系列而非 HEADLESS_PREFIX，兩者的規則編號與內容需分別確認。
-**Priority**: P2
-**Complexity**: simple
-**Role**: developer
-
-**Scope Paths** (你只能操作這些路徑):
-- .formation/tools/prompt.js
-- .formation/tools/dispatch.js
-
-**Requirements**:
-- SUBAGENT_PREFIX_DIRECT 不得再指示 git add -A；改為僅 stage 明確編輯過的路徑，並附上共用工作樹的警示（比照 TASK_1819 在 serial 步驟加的 TASK_188 註記）
-- SUBAGENT_PREFIX（worktree 隔離）的 git add -A 必須保留不變 —— TASK_1784 DEFECT-A 已證實移除提交指示會讓 literal-obedience 模型產生零 commit 並觸發 leak detector
-- 確認兩個前綴的規則編號與內容在本次改動後仍然一致且不矛盾；rune_704eeb83 記載兩者逐字重複規則 12/13/14，已有三次 commit 需要同步修改
-- 實際驗證跨專案路徑確實選到 DIRECT 前綴，而非僅靠讀碼推論
-
-**Acceptance Criteria**:
-- 以跨專案參數（--project-path 指向另一個專案）跑 dispatch.js --dispatch-mode=subagent，輸出的 promptText 中 git add -A 計數為 0，且仍含可用的 commit 指令
-- 以同專案參數跑同一指令，git add -A 仍存在（worktree 隔離路徑行為不變）
-- 兩種情境的 JSON 輸出皆可解析，agentParams 完整
-- node --check .formation/tools/prompt.js 通過
-- .formation/tools/__tests__ 全綠（subagent-bifrost-guard 39/39、m1-claim-gate 16/16）
-
-**Technical Notes**:
-- rune_704eeb83（本卡最相關的一條）：這兩個常數是 JS template literal，規則文字中任何未跳脫的反引號會終結 literal 並讓 prompt.js 整個解析失敗，連帶弄垮所有 dispatch。這曾經差點出貨（被 node --check 擋下）。改完務必 node --check 加一次真實的 --dispatch-mode=subagent JSON 輸出 smoke test。
-- 前綴選用邏輯在 dispatch.js:1351；isCrossProject 的計算在 1347 行附近，使用 samePath() 做分隔符與大小寫不敏感比對（TASK_1710 修過：原本的字串比對在 C:/ 對 C:\ 時失效，静默丟掉隱離）。
-- TASK_1819 已將 HEADLESS_PREFIX 規則 6 從硬編碼 git add -A 改為依 workflow step 所示執行。本卡走的是 SUBAGENT_PREFIX 系列而非 HEADLESS_PREFIX，兩者規則編號不同，不要假設改了一邊另一邊也好了。
-- TASK_1672 的設計約束不得推翻：跨專案派工確實不能用 worktree 隔離（Agent tool 的 worktree 從 conversation cwd 的 repo 推導）。本卡不是要把跨專案改回 worktree，而是在確定無隔離的前提下讓提交行為安全。
-
-## Workflow
-### 認知 recall
-Note: 跳過此步 = 可能重複踩坑。Synapse 是預設搜尋工具，Grep 只用於精確字串匹配。
-- 用 ToolSearch 確認 synapse MCP tools 可用
-- 對 scope_paths 涉及的 symbol 呼叫 synapse_recall，了解已知的 risk/decision/fix
-- 如有相關 rune，在執行時避免踩已知地雷或破壞已記錄的設計意圖
-
-### 執行任務
-- 根據 scope_paths 讀取相關檔案
-- 根據 requirements 逐一實作
-- 根據 acceptance_criteria 驗證成果
-
-### 提交變更
-Command: git add -A && (git commit --no-verify -m "[TASK_1824] task completed" || true)
-Note: worktree 內顯式提交確保 post-complete 只需 merge 不需 recovery commit。
-nothing to commit 時靜默跳過，不報錯。
-⚠️ 若前一步有 Edit 但 git add -A 找不到變更，代表路徑用錯了（用了主 repo 路徑）。
-修復方式：先 echo $PWD 確認 worktree root，再用 worktree 絕對路徑重新 Edit。
-
-
-### 認知 inscribe
-Note: 你的發現會在對話結束時消失。Inscribe 讓未來 agent 不必重新探索。
-- 回顧工作中是否發現 non-obvious 的知識（bug 根因、隱藏約束、設計決策理由）
-- 如有，用 synapse_inscribe 記錄（confidence >= 0.6，英文撰寫）
-- 如發現 3+ symbol 構成未命名的概念，考慮用 synapse_forge 建立 Sigil
-- inscribe 後，用 synapse_rune_conflicts({ scope: '<你改的檔案路徑>' }) 檢查是否與已有 rune 矛盾
-
-### 完成任務
-Note: ⚠️ Worktree mode — 禁止執行 task-api.js complete。主 thread 在 merge + 驗證後處理。
-
-### On Blocked
-Command: node .collaboration/core/task-api.js move TASK_1824 blocked
-Note: 遇到無法解決的阻礙時，移至 blocked/ 並在摘要中說明原因
-
-## Expected Output
-Primary: 程式碼變更或檔案修改
-Secondary: 完成摘要（做了什麼、改了哪些檔案、需要注意的事）
-
-## Progress Note (mandatory — write before finishing)
-
-When you finish your work, **before your final response**, write a structured progress note to the chart.
-
-**Chart path (for reference only — do NOT use the Write tool on this path)**: `C:/Users/user/Documents/GitHub/KenazAI/.specialist/sessions/chart_TASK_1824.json`
-
-**Steps** (avoids cross-workspace permission prompts — works for same-repo and cross-project workers):
-1. Write the note JSON to a **project-local** file inside your own workspace (safe — no cross-boundary write):
-   File: `.kenaz/specialist/progress_note_TASK_1824.json`
-   Use the Write tool to create that file (it is inside your cwd, so no permission prompt occurs).
-   Ensure `.kenaz/specialist/` directory exists first (create it if absent).
-
-2. Run the phase-gate note subcommand via **Bash** to merge it into the core chart:
-   ```bash
-   node "C:/Users/user/Documents/GitHub/KenazAI/.specialist/tools/phase-gate.js" note --task=TASK_1824 --from-file=".kenaz/specialist/progress_note_TASK_1824.json"
-   ```
-   *(The note file is in your local workspace — no cross-workspace Write; phase-gate note merges it into the core chart atomically)*
-
-**Progress Note Schema** (ONE entry to append to `progress_notes`):
-
-```json
-{
-  "task_id": "TASK_1824",
-  "timestamp": "<ISO-8601>",
-  "changes": { "files_modified": ["<paths>"], "files_created": [], "files_deleted": [], "total_lines": 0 },
-  "acceptance_criteria": [
-    { "criterion": "以跨專案參數（--project-path 指向另一個專案）跑 dispatch.js --dispatch-mode=subagent，輸出的 promptText 中 git add -A 計數為 0，且仍含可用的 commit 指令", "status": "pass|fail|partial", "evidence": "<brief>" },
-    { "criterion": "以同專案參數跑同一指令，git add -A 仍存在（worktree 隔離路徑行為不變）", "status": "pass|fail|partial", "evidence": "<brief>" },
-    { "criterion": "兩種情境的 JSON 輸出皆可解析，agentParams 完整", "status": "pass|fail|partial", "evidence": "<brief>" },
-    { "criterion": "node --check .formation/tools/prompt.js 通過", "status": "pass|fail|partial", "evidence": "<brief>" },
-    { "criterion": ".formation/tools/__tests__ 全綠（subagent-bifrost-guard 39/39、m1-claim-gate 16/16）", "status": "pass|fail|partial", "evidence": "<brief>" },
-  ],
-  "findings": ["<non-obvious discoveries, traps, design decisions>"],
-  "deviations": ["<anything done differently from the plan; REQUIRED to document a skipped inscribe>"],
-  "cognitive_output": { "runes": ["<rune_ids -- [] if none>"], "sigils": ["<sigil_ids -- [] if none>"] }
-}
-```
-
-**Rules**:
-- Evaluate EVERY Acceptance Criterion; use exact criterion text from the task.
-- `changes`: list ALL files touched (created/modified/deleted).
-- `findings`: non-obvious constraints, design traps, discoveries -- [] if none.
-- `cognitive_output.runes/sigils` = IDs from synapse calls ([] if none); if you skip inscribe, say why in `deviations` (verify-identity reads it as the skip explanation).
-- If the chart file does not exist, the note subcommand creates it automatically -- NEVER use the Write tool on the chart path directly.
-
-
-## Before You Start — Cognitive Recall (mandatory verdict)
-Before writing any code, you MUST perform a cognitive recall (synapse_recall or synapse_pulse) on the symbols you are about to modify.
-
-Output exactly one of these lines before you start coding:
-
-```
-📡 Cognitive Recall: {one-line summary of what pulse/recall revealed}
-```
-
-Or, if you consciously decide to skip:
-
-```
-📡 Cognitive Recall: SKIP — {reason why recall is unnecessary}
-```
-
-You may SKIP, but you must say why. Silence is not allowed.
-
-## Before You Finish — Don't Let Your Discovery Die
-You just spent real effort understanding this code. When this conversation ends, everything you learned disappears — unless you write it down.
-
-Ask yourself:
-- Did you trace a bug to a root cause that wasn't obvious from the code? → The next agent will waste hours rediscovering it. **inscribe type=fix**
-- Did you find a function that behaves differently than its name suggests, or has a hidden constraint? → That's a trap waiting to spring. **inscribe type=risk**
-- Did you choose approach A over B for a reason that isn't obvious? → Without your reasoning, someone will undo your work. **inscribe type=decision**
-- Did you realize that 3+ symbols are actually part of the same concept? → Give it a name. **synapse_forge** a Sigil.
-
-If none of these apply, skip. Don't write for the sake of writing.
-
-When you do write:
-- **English only** — code is English, runes should be too. This is mandatory: all memory write fields (synapse_inscribe content/context, hippocampus episode scope/lesson/summary) MUST be in English. SQLite FTS5 tokenizer does not handle CJK — Chinese content will return 0 results on recall. (Rule: MEM-LANG-001)
-- confidence >= 0.6 — if you're guessing, don't inscribe.
-- One good rune > three mediocre ones.
-- ⚠️ **Always pass `projectPath` to all Synapse tool calls** — use the projectPath determined in Phase 0. Multi-session collisions occur when concurrent sessions omit projectPath and fall back to the global default project.
-
-Every rune you inscribe will be recalled by the next agent who touches the same symbol. Your insight becomes their head start.
-
-## Cognitive Checkpoint (mandatory — include in your final output)
-At the very end of your response, output this block exactly:
-
-```
-## Cognitive Checkpoint
-Pre-code: RECALLED — {what you found} | or SKIP — {reason}
-Post-code: INSCRIBED — {rune_id} | or SKIP — {reason}
-```
-
-Both verdicts are required. You may SKIP either, but you must state why.
-
-
-## Cortex Context (Related Files Preview)
-The following files are in your scope. Review them before making changes.
-
-### .formation/tools/prompt.js (2014 lines)
-```
-/**
- * Formation Prompt Builder
- * 根據陣型和技能定義組裝 prompt
- *
- * 每個陣型有不同的 prompt 結構：
- * - unit:   角色 + 行為 + 任務 + 工作流程 + 輸出
- * - solo:   角色 + 視角列表 + 行為 + 任務 + 工作流程 + 輸出
- * - squad:  為每個成員分別組裝 prompt（含分工 scope）
- * - legion: 為 team lead + 每個成員分別組裝 prompt（含溝通規則）
- */
-
-// ─────────────────────────────────────────
-// Memory Loader（記憶系統整合）
-// ─────────────────────────────────────────
-let memoryLoader = null;
-try {
-  memoryLoader = require('./memory-loader');
-} catch { /* memory-loader not available — graceful degradation */ }
-
-// ─────────────────────────────────────────
-// Shared Principles Loader（共享原則注入）
-// ─────────────────────────────────────────
-const fs = require('fs');
-const path = require('path');
-
-// Shared core-path resolver (validates existsSync+isDirectory, falls back to KENAZ_SOURCE_DIR)
-let _resolveCoreDir = null;
-try {
-  _resolveCoreDir = require(path.join(__dirname, '..', '..', '.claude', 'hooks', 'core-resolve')).resolveCoreDir;
-} catch { /* graceful degradation — older installs without the export */ }
-... (truncated)
-```
-
-### .formation/tools/dispatch.js (1381 lines)
-```
-#!/usr/bin/env node
-/**
- * Formation Dispatch — CLI 入口
- *
- * 根據陣型調度 subagent 執行任務。
- * 實際邏輯分散在各模組：loader, prompt, runner, logger, utils。
- *
- * Usage:
- *   node .formation/tools/dispatch.js --skill=do --task=TASK_172
- *   node .formation/tools/dispatch.js --formation=solo --skill=strategy --task=TASK_172
- *   node .formation/tools/dispatch.js --formation=squad --skill=blitz --task=TASK_173
- *   node .formation/tools/dispatch.js --formation=legion --skill=forge --task=TASK_174 --dry-run
- */
-
-const path = require('path');
-const fs = require('fs');
-const { loadSkill, loadTask } = require('./loader');
-const { buildPrompt, SUBAGENT_PREFIX, SUBAGENT_PREFIX_DIRECT } = require('./prompt');
-const { runSingle, runParallel } = require('./runner');
-const { generateSessionId, ensureGitReady, ROOT, readDashboardModels } = require('./utils');
-const { refreshCache, hasRemoteConflict, hasRemoteFileConflict, isCacheStale } = require('./remote-conflict');
-
-// TASK_1815: the Agent tool's `model` parameter accepts ONLY these Claude
-// family names — no versions, no [1m] speed modifiers, no full model ids.
-// Measured 2026-07-26 by a direct Agent tool probe from the main thread:
-// model="claude-fable-5" and model="gpt-5-codex" both raise the SAME
-// InputValidationError listing exactly this enum. This is a harness-side
-// constraint that may drift with Claude Code versions — keep the four values
-// in THIS single constant; if subagent dispatch starts failing with
-// InputValidationError on the model field, re-probe the Agent tool and update
-... (truncated)
-```