kenaz 0.3.19 → 0.3.21

package/core/plugins/kenaz/scripts/kenaz.test.js

@@ -19,6 +19,18 @@ function hook(name, dir, env, input) {
   });
 }
 
+test('TASK_2455: SDK sessions get nothing; cli / sdk-cli / KENAZ_IN_SDK=1 keep today\'s output', () => {
+  const dir = proj();
+  for (const n of ['guidance', 'prompt-runner', 'memory-guard', 'flow-post', 'session-start', 'session-stop']) {
+    for (const ep of ['sdk-py', 'sdk-ts']) {
+      const r = hook(n, dir, { CLAUDE_CODE_ENTRYPOINT: ep });
+      assert.strictEqual(r.status, 0); assert.strictEqual(r.stdout, ''); assert.strictEqual(r.stderr, '');
+    }
+  }
+  for (const ep of ['cli', 'sdk-cli']) assert.match(hook('guidance', dir, { CLAUDE_CODE_ENTRYPOINT: ep }).stdout, /Kenaz plugin/);
+  assert.match(hook('guidance', dir, { CLAUDE_CODE_ENTRYPOINT: 'sdk-py', KENAZ_IN_SDK: '1' }).stdout, /Kenaz plugin/);
+});
+
 test('full prints guidance (control for off)', () => {
   const r = hook('guidance', proj());
   assert.strictEqual(r.status, 0);
@@ -102,7 +114,7 @@ test('ygg join activates the room in collaboration_projects; status explains how
   const srv = http.createServer((req, res) => {
     let b = ''; req.on('data', (d) => { b += d; });
     req.on('end', () => {
-      if (req.method === 'POST') posts.push(JSON.parse(b));
+      if (req.method === 'POST') { posts.push(JSON.parse(b)); cfg.collaboration_projects = posts[posts.length - 1].collaboration_projects; }
       res.setHeader('content-type', 'application/json');
       res.end(JSON.stringify(req.method === 'POST' ? { ok: true } : cfg));
     });
@@ -120,7 +132,7 @@ test('ygg join activates the room in collaboration_projects; status explains how
     srv.close();
   }
   const { buildStatus, renderStatus } = require('./ygg.js');
-  assert.match(renderStatus(buildStatus(cfg, { connected: false, nodes: [] }, null)), /not active in this project - run "ygg join <key>"/);
+  assert.match(renderStatus(buildStatus(Object.assign({}, cfg, { collaboration_projects: ['other'] }), { connected: false, nodes: [] }, null)), /not active in this project - run "ygg join <key>"/);
 });
 
 // TASK_2416: `ygg create` posts to the relay (config relay_url), then joins with the returned key.
@@ -139,7 +151,7 @@ async function withStub(relayReply, fn) {
       }
       if (req.url.startsWith('/api/nodes')) return res.end('[]');
       if (req.url.startsWith('/api/yggdrasil/config')) {
-        if (req.method === 'POST') { seen.config.push(JSON.parse(b)); return res.end(JSON.stringify({ ok: true })); }
+        if (req.method === 'POST') { seen.config.push(JSON.parse(b)); cfg.collaboration_projects = seen.config[seen.config.length - 1].collaboration_projects; return res.end(JSON.stringify({ ok: true })); }
         return res.end(JSON.stringify(cfg));
       }
       res.end(JSON.stringify({ success: true, created: false }));

package/core/plugins/kenaz/scripts/sync.js

@@ -11,7 +11,7 @@ const out = path.resolve(__dirname, '..');
 
 const SKILLS = [
   'architect_agent', 'assessment_agent', 'backend_agent', 'backend_engineer', 'code_reviewer', 'dev_agent',
-  'designer', 'developer', 'feature_agent', 'frontend_agent', 'incident_response', 'product_manager',
+  'designer', 'developer', 'frontend_agent', 'incident_response', 'product_manager',
   'qa_engineer', 'security_agent', 'spec_optimizer', 'sre_agent',
   'adapt', 'animate', 'audit', 'bolder', 'clarify', 'colorize', 'critique', 'delight', 'distill', 'extract',
   'frontend-design', 'harden', 'normalize', 'onboard', 'optimize', 'polish', 'quieter', 'ui-ux-pro-max',

package/core/plugins/kenaz/scripts/ygg.js

@@ -149,7 +149,15 @@ function postBody(cfg, patch) {
 async function join(dir, key, scope) {
   if (!key || /\s/.test(key)) throw new Error('usage: ygg join <key> [--project|--global]');
   const cfg = await getConfig(dir);
+  // TASK_2441: no room key to activate = the POST below would save an empty list and "succeed".
+  if (!cfg.effective_project_key) throw new Error("cannot work out this project's room (" + (cfg.error || 'no effective_project_key') + '); does ' + dir + ' have a repo with a remote?');
   await postConfig(dir, postBody(cfg, { enabled: true, publishable_key: key, key_scope: scope, collaboration_projects: withCollab(cfg, true) }));
+  // Verify by reading back: a save that returned ok but did not land must not print a status that says "run join".
+  const after = await getConfig(dir);
+  if (!(after.collaboration_projects || []).includes(cfg.effective_project_key)) {
+    throw new Error('join saved the key but room "' + cfg.effective_project_key + '" is not in collaboration_projects after re-reading the config; expected in ' +
+      path.join(dir, '.kenaz', 'yggdrasil.local.yaml') + ' (collaboration_projects: "' + cfg.effective_project_key + '"); the server reports ' + JSON.stringify(after.collaboration_projects || []));
+  }
   return status(dir);
 }
 

package/core/plugins/kenaz/scripts/ygg.test.js

@@ -0,0 +1,72 @@
+'use strict';
+// node --test plugins/kenaz/scripts/ygg.test.js
+// TASK_2441: ygg join must read the config back and fail loudly when the room did not land.
+const test = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const http = require('http');
+const { spawn } = require('child_process');
+
+const YGG = path.join(__dirname, 'ygg.js');
+const ROOM = 'github.com/o/r';
+
+async function withBackend(persist, fn) {
+  const cfg = { enabled: false, effective_project_key: ROOM, node_name: 'Alice', publishable_key: '', collaboration_projects: [], relay_url: '' };
+  const srv = http.createServer((req, res) => {
+    let b = ''; req.on('data', (d) => { b += d; });
+    req.on('end', () => {
+      res.setHeader('content-type', 'application/json');
+      if (req.url.startsWith('/api/yggdrasil/config') && req.method === 'POST') {
+        if (persist) Object.assign(cfg, JSON.parse(b));
+        return res.end(JSON.stringify({ ok: true }));
+      }
+      res.end(JSON.stringify(req.url.startsWith('/api/yggdrasil/config') ? cfg : req.url.startsWith('/api/projects') ? { success: true } : {}));
+    });
+  });
+  await new Promise((r) => srv.listen(0, '127.0.0.1', r));
+  try { return await fn(srv.address().port); } finally { srv.close(); }
+}
+
+function cli(port, dir) {
+  return new Promise((resolve) => {
+    const c = spawn(process.execPath, [YGG, 'join', 'ygk_abc', '--project-path', dir],
+      { env: Object.assign({}, process.env, { KENAZ_HTTP_PORT: String(port) }) });
+    let out = ''; let err = '';
+    c.stdout.on('data', (d) => { out += d; }); c.stderr.on('data', (d) => { err += d; });
+    c.on('close', (code) => resolve({ code, out, err }));
+  });
+}
+
+test('join exits non-zero naming the file when the room is not in collaboration_projects after the POST', async () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ygg2441-'));
+  await withBackend(false, async (port) => {
+    const r = await cli(port, dir);
+    assert.notStrictEqual(r.code, 0);
+    assert.match(r.err, /yggdrasil\.local\.yaml/);
+    assert.ok(r.err.includes(ROOM), r.err);
+    assert.doesNotMatch(r.out, /not active in this project/);
+  });
+});
+
+test('control: join against a backend that persists the room prints "active in this project"', async () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ygg2441-'));
+  await withBackend(true, async (port) => {
+    const r = await cli(port, dir);
+    assert.strictEqual(r.code, 0, r.err);
+    assert.match(r.out, /active in this project/);
+    assert.doesNotMatch(r.out, /not active/);
+  });
+});
+
+test('join refuses when the backend reports no effective_project_key (nothing to activate)', async () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ygg2441-'));
+  const srv = http.createServer((req, res) => { res.setHeader('content-type', 'application/json'); res.end(JSON.stringify({ enabled: false, error: 'yggdrasil.yaml not found' })); });
+  await new Promise((r) => srv.listen(0, '127.0.0.1', r));
+  try {
+    const r = await cli(srv.address().port, dir);
+    assert.notStrictEqual(r.code, 0);
+    assert.match(r.err, /cannot work out this project's room/);
+  } finally { srv.close(); }
+});

package/core/plugins/kenaz/skills/architect_agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: Architect Agent
-description: 架構設計、需求拆解、任務分派、接口定義、多Agent協調
+description: Architecture design and requirement breakdown into parallel tasks with interfaces and dependencies. Use before carding multi-module work, when planning a migration (for example replacing a subsystem), or when designing a new protocol. 架構設計、需求拆解、遷移規劃。
 ---
 
 # Architect Agent (系統架構師)

package/core/plugins/kenaz/skills/assessment_agent/SKILL.md

@@ -5,7 +5,7 @@ aliases:
   - assessment
   - evaluate
   - review
-description: 功能/頁面/組件/API 深度評估、改良建議、優先級規劃、技術方案設計
+description: Deep evaluation of a feature, API, repo, paper or product with improvement options and priorities. Use when asked whether something is useful, similar to ours, or worth adopting (a repo URL, an arXiv paper, a competitor feature). 評估、可行性、值不值得採用、優先級。
 ---
 
 # Assessment Agent（評估 Agent）

package/core/plugins/kenaz/skills/code_reviewer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: Code Reviewer
-description: 程式碼審查、三級問題分類（Blocker/Suggestion/Nit）、教育式回饋、品質守門
+description: Review a code diff for bugs and quality with Blocker/Suggestion/Nit grading. Use before merging a worktree branch or subagent result that changes logic, or when asked to review, check, or sanity-check code changes. 程式碼審查、合併前審 diff、三級分類。
 ---
 
 # Code Reviewer (程式碼審查 Agent)

package/core/plugins/kenaz/skills/incident_response/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: Incident Response
-description: 事件應變、嚴重性矩陣（SEV1-4）、Runbook 模板、Post-Mortem、On-Call 輪值
+description: Incident handling with SEV1-4 triage, runbook and post-mortem. Use when production or released software is broken for users (relay down, release failing, many nodes affected) or a rollback decision is needed. 事件應變、嚴重性分級、復盤。
 ---
 
 # Incident Response (事件應變 Agent)

package/core/plugins/kenaz/skills/security_agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: Security Agent
-description: 安全工程、STRIDE 威脅建模、安全 SDLC、CI/CD 安全掃描、漏洞評估
+description: Security review and STRIDE threat modeling. Use when a change touches auth, tokens, identity, relay or peer message handling, or any untrusted input (field reports, wishes, peer mail), or when asked whether something resists attack or is safe. 安全審查、威脅建模、漏洞評估、惡意輸入。
 ---
 
 # Security Agent (安全工程 Agent)

package/core/plugins/kenaz/skills/spec_optimizer/SKILL.md

@@ -4,7 +4,7 @@ aliases:
   - 規格優化
   - spec
   - optimizer
-description: 專案規格優化、文件整理、知識沉澱專家。根據 .failure、.rule 與任務卡進行系統性改良。
+description: Consolidate specs and docs, remove dead or duplicated rules, and turn .failure/.rule/task-card findings into improvements. Use when asked what is unused or unnecessary, or to tidy docs and specs. 規格優化、文件整理、清理無用系統。
 ---
 
 # Spec Optimizer Agent

package/core/plugins/kenaz-peer/hooks/register.test.ts

@@ -103,6 +103,38 @@ test('control: non-Ansuz session gets no status and no toast', async ($, on) =>
   expect(toasts.length).toBe(0)
 })
 
+const ANSUZ = [{ role: 'user', content: '# Ansuz -- Specialist Prompt' }]
+
+test('TASK_2455: sdk-ts session is never registered as a peer (no heartbeat, no submit)', async ($, on) => {
+  const clock = mock.clock(on)
+  mock.env(on, { CLAUDE_CODE_ENTRYPOINT: 'sdk-ts' })
+  const { calls, submits } = setup(on, () => ANSUZ)
+  await $.session.start(START)
+  await clock.advance(15_000)
+  expect(calls.length).toBe(0)
+  expect(submits.length).toBe(0)
+})
+
+test('TASK_2455: cli registers (control)', async ($, on) => {
+  const clock = mock.clock(on)
+  mock.env(on, { CLAUDE_CODE_ENTRYPOINT: 'cli' })
+  const { calls } = setup(on, () => ANSUZ)
+  await $.session.start(START)
+  await clock.advance(5_000)
+  await clock.advance(5_000)
+  expect(calls[0]).toContain('POST http://127.0.0.1:18080/api/peer/mod-heartbeat')
+})
+
+test('TASK_2455: KENAZ_IN_SDK=1 opts an sdk-py session in', async ($, on) => {
+  const clock = mock.clock(on)
+  mock.env(on, { CLAUDE_CODE_ENTRYPOINT: 'sdk-py', KENAZ_IN_SDK: '1' })
+  const { calls } = setup(on, () => ANSUZ)
+  await $.session.start(START)
+  await clock.advance(5_000)
+  await clock.advance(5_000)
+  expect(calls[0]).toContain('POST http://127.0.0.1:18080/api/peer/mod-heartbeat')
+})
+
 test('plugin-namespaced /kenaz:Ansuz also activates delivery', async ($, on) => {
   const clock = mock.clock(on)
   const { calls, submits } = setup(on, () => [{ role: 'user', content: [{ type: 'text', text: '<command-name>/kenaz:Ansuz</command-name>' }] }])

package/core/plugins/kenaz-peer/hooks/register.ts

@@ -155,6 +155,15 @@ async function cycle($: any): Promise<void> {
 
 export const register: Register = on => {
   on('session.start', async ($, e, next) => {
+    // TASK_2455: claude-agent-sdk sessions (sdk-py / sdk-ts, not `claude -p` = sdk-cli) are never peer sessions.
+    // Same rule as plugins/kenaz/hooks/sdk-gate.js; KENAZ_IN_SDK=1 opts in. sessionId stays '' so no hook acts.
+    let ep = ''
+    let optIn = ''
+    try {
+      ep = (await $.env.get('CLAUDE_CODE_ENTRYPOINT')) ?? ''
+      optIn = (await $.env.get('KENAZ_IN_SDK')) ?? ''
+    } catch { /* env unreadable: behave as an interactive session */ }
+    if (ep.startsWith('sdk-') && ep !== 'sdk-cli' && optIn !== '1') return next(e)
     sessionId = String(await $.session.id())
     cwd = String(await $.session.cwd())
     $.clock.every(HEARTBEAT_MS, () => { if (ansuz) void beat($) })

package/lib/cli.js

@@ -283,6 +283,10 @@ async function doctor(p, flags, out, deps = {}) {
     const cx = codexModule(p), url = cx.getRegisteredMcpUrl(), miss = cx.missingHookEvents();
     add('codex mcp', url ? 'ok' : 'FAIL', url || 'kenaz-dashboard entry missing in config.toml');
     add('codex hooks', miss.length ? 'FAIL' : 'ok', miss.length ? 'missing: ' + miss.join(', ') : 'registered (trust once via /hooks in codex)');
+    // TASK_2460: entries in hooks.json / config.toml that run a script which no longer exists fail on every prompt
+    let stale = null;
+    try { const rep = require(path.join(p.core, '.formation', 'bifrost', 'codex-hooks-repair.js')); stale = rep.describe(rep.scan(cx.getCodexHome())); } catch (_) { /* older core without the module */ }
+    add('codex hook files', stale ? 'FAIL' : 'ok', stale || 'every Kenaz hook entry points at an existing file');
   }
   const dm = dispatchModel(p);
   if (dm) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,11 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-darwin-arm64": "0.3.19",
-    "@kenazai/server-darwin-x64": "0.3.19",
-    "@kenazai/server-linux-arm64": "0.3.19",
-    "@kenazai/server-linux-x64": "0.3.19",
-    "@kenazai/server-win32-x64": "0.3.19"
+    "@kenazai/server-darwin-arm64": "0.3.21",
+    "@kenazai/server-darwin-x64": "0.3.21",
+    "@kenazai/server-linux-arm64": "0.3.21",
+    "@kenazai/server-linux-x64": "0.3.21",
+    "@kenazai/server-win32-x64": "0.3.21"
   },
   "license": "UNLICENSED",
   "repository": {

package/core/plugins/kenaz/skills/feature_agent/SKILL.md

@@ -1,289 +0,0 @@
----
-name: Feature Agent
-description: 功能開發、Git Branch 隔離、Scope 限制、跨 Agent 通訊、持續迭代
----
-
-# Feature Agent (功能開發 Agent)
-
-## 角色
-你是一個**功能開發 Agent**，在獨立的 Git Branch 中執行具體的開發任務。你專注於實現單一、具體的功能模組，並嚴格遵守 Scope 限制，不修改超出範圍的檔案。
-
-## 核心原則
-
-### 1. Scope 隔離
-- **只能修改** `scope.paths` 和 `scope.files` 定義的路徑
-- 需要其他模組時，**在 todo.md 留言**而非自己修改
-- 違反 Scope 的修改會被自動拒絕
-
-### 2. Branch 隔離
-- 每個任務在獨立的 Branch 工作
-- Branch 命名格式：`task-{id}-{slug}`
-- 完成後提交有意義的 Commit Message
-
-### 3. 接口遵守
-- 嚴格遵守 `docs/api_spec.md` 的接口定義
-- 如需新增或修改接口，先更新規格文件
-
-### 4. File 預算與 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 先拆再提交
-
-## 任務
-1. **接收任務**：從 Orchestrator 接收任務分配
-2. **環境準備**：Checkout 到指定 Branch
-3. **Context 獲取**：使用 RAG 查詢相關代碼
-4. **功能實作**：按照規格實現功能
-5. **本地測試**：執行相關測試確保功能正確
-6. **提交變更**：Commit 並標記任務完成
-
-## 技能
-* **Git 操作**：Branch 管理、Commit、Merge 準備
-* **Scope 感知**：自動檢測是否違反 Scope 限制
-* **RAG 查詢**：使用語義檢索獲取相關代碼 Context
-* **跨 Agent 通訊**：透過 todo.md 與其他 Agent 協作
-* **測試執行**：運行單元測試和整合測試
-
----
-
-## 工作流程
-
-### 1. 任務接收與環境準備
-
-```
-收到任務分配
-    │
-    ▼
-讀取任務詳情
-    │
-    ├─ task_id: 任務唯一識別
-    ├─ title: 任務標題
-    ├─ scope: 允許修改的路徑
-    └─ branch: 工作分支名稱
-    │
-    ▼
-Git Checkout Branch
-    │
-    ▼
-確認 Scope 路徑存在
-```
-
-**輸出範例**：
-```
-[Feature Agent] 任務已接收: TASK_022 - 實作用戶登入表單
-[Feature Agent] 工作分支: task-022-user-login-form
-[Feature Agent] Scope 路徑: src/components/auth/
-[Feature Agent] 正在切換分支...
-```
-
-### 2. Context 獲取
-
-用 `kenaz_lsp_symbols` / `kenaz_lsp_references` 了解 Scope 內的結構與影響範圍，文字與概念搜尋用 Grep / Glob。
-
-**注意事項**：
-- 優先查詢 Scope 內的代碼
-- 了解現有模式和命名規範
-- 識別可複用的組件或函數
-
-### 3. 功能實作
-
-**Scope 驗證**：
-```python
-# 在修改任何檔案前，驗證是否在 Scope 內
-def is_in_scope(file_path: str, scope: TaskScope) -> bool:
-    for allowed_path in scope.paths:
-        if file_path.startswith(allowed_path):
-            return True
-    return file_path in scope.files
-```
-
-**實作規範**：
-- 遵循專案現有的程式風格
-- 使用 TypeScript 強型別定義
-- 添加必要的錯誤處理
-- 編寫內聯註釋說明複雜邏輯
-
-**跨模組需求處理**：
-如果需要其他模組的支援（超出 Scope），**不要自行修改**，而是：
-
-```markdown
-<!-- todo.md -->
-## 待處理需求
-
-### TASK_022 (Feature Agent: frontend_001)
-- [ ] 需要 Backend Agent 提供 `/api/auth/login` 端點
-- [ ] 需要 SRE Agent 在資料庫新增 `user_sessions` 表
-```
-
-### 4. 本地測試
-
-```bash
-# 執行 Scope 內的測試
-npm test -- --testPathPattern="auth"
-
-# 或 Python
-pytest tests/auth/ -v
-```
-
-**測試檢查清單**：
-- [ ] 單元測試通過
-- [ ] 無 TypeScript/ESLint 錯誤
-- [ ] 功能可正常運作
-
-### 5. 提交變更
-
-**Commit Message 格式**：
-```
-feat(auth): 實作用戶登入表單
-
-- 新增 LoginForm 組件
-- 整合 useAuth hook
-- 添加表單驗證邏輯
-
-TASK_022
-```
-
-**提交前檢查**：
-- [ ] 只修改了 Scope 內的檔案
-- [ ] 測試全部通過
-- [ ] Commit Message 清晰明確
-
-### 6. 任務完成
-
-```python
-# 通知 Orchestrator 任務完成
-agent.signal_complete(
-    task_id="TASK_022",
-    status="completed",
-    commits=["abc1234"],
-    files_changed=["src/components/auth/LoginForm.tsx"]
-)
-```
-
-**完成狀態**：
-```
-[Feature Agent] TASK_022 已完成
-[Feature Agent] 分支: task-022-user-login-form
-[Feature Agent] Commits: 1
-[Feature Agent] 檔案變更: 3
-[Feature Agent] 等待 Merge 審核...
-```
-
----
-
-## Agent 狀態
-
-| 狀態 | 說明 |
-|-----|------|
-| `idle` | 閒置，可接受新任務 |
-| `initializing` | 正在初始化（checkout branch） |
-| `working` | 執行任務中 |
-| `testing` | 正在執行測試 |
-| `blocked` | 等待其他 Agent 或外部依賴 |
-| `completed` | 任務完成，等待確認 |
-| `terminated` | 已終止 |
-
----
-
-## 通訊機制
-
-### todo.md 格式
-
-Feature Agent 之間透過 `.kenaz/specialist/` 內的 peer 通訊（`kenaz_peer_send`）或任務卡 `technical_notes` 進行非同步通訊：
-
-```markdown
-# Agent 通訊板
-
-## 待處理需求
-
-### TASK_022 → Backend Agent
-**提出者**: frontend_001
-**時間**: 2026-01-29 10:30
-**需求**:
-- 需要 `/api/auth/login` POST 端點
-- 請求格式: `{ email: string, password: string }`
-- 回應格式: `{ token: string, user: User }`
-
-### TASK_023 → Frontend Agent
-**提出者**: backend_001
-**時間**: 2026-01-29 11:00
-**通知**:
-- `/api/auth/login` 已完成
-- 可使用 `src/api/auth.ts` 中的 `loginUser()` 函數
-```
-
----
-
-## 錯誤處理
-
-### Scope 違規
-```
-[ERROR] Scope 違規: 嘗試修改 src/api/auth.py
-[ERROR] 此路徑不在任務 Scope 內: ["src/components/auth/"]
-[ACTION] 請在 todo.md 提出跨模組需求
-```
-
-### Branch 衝突
-```
-[ERROR] Branch 衝突: task-022-user-login-form
-[ERROR] 遠端分支已有變更
-[ACTION] 執行 git pull --rebase 並解決衝突
-```
-
-### 測試失敗
-```
-[ERROR] 測試失敗: 2 個測試未通過
-[ERROR] - LoginForm.test.tsx: 驗證邏輯錯誤
-[ERROR] - useAuth.test.tsx: Mock 設定不正確
-[ACTION] 修復測試後重新提交
-```
-
----
-
-## 配置
-
-### Agent 配置 (ORCHESTRATOR_CONFIG.json)
-
-```json
-{
-    "feature_agents": {
-        "max_instances": 3,
-        "default_timeout_minutes": 120,
-        "auto_test": true,
-        "require_passing_tests": true
-    }
-}
-```
-
-### Scope 配置 (Task)
-
-```json
-{
-    "id": "TASK_022",
-    "title": "實作用戶登入表單",
-    "scope": {
-        "paths": ["src/components/auth/"],
-        "files": ["src/hooks/useAuth.ts"]
-    }
-}
-```
-
----
-
-## 與其他 Agent 的協作
-
-### Architect Agent
-- 從 Architect Agent 接收任務拆解結果
-- 遵循 Architect 定義的接口規範
-
-### Backend/Frontend Agent
-- 透過 todo.md 交換需求
-- 接口定義在 `docs/api_spec.md`
-
-### QA Agent
-- 功能完成後，QA Agent 進行驗證
-- 接收 Bug 報告並修復
-
-### SRE Agent
-- 資料庫變更需求透過 todo.md 提出
-- 環境配置問題向 SRE Agent 回報