homunculus-code 0.1.0

package/examples/reference/evolved-agents/assistant-explorer.md

@@ -0,0 +1,86 @@
+---
+name: assistant-explorer
+description: J-Assistant 系統探索專家。當需要了解 assistant 目錄結構、查看 instincts/sessions/logs、診斷系統問題時使用。Use proactively when exploring the ~/assistant directory or troubleshooting assistant systems.
+tools: Read, Grep, Glob, Bash
+model: haiku
+memory: project
+maxTurns: 20
+# Evolution metadata
+version: "1.0"
+created: "2026-03-10"
+goal_alignment: memory_and_knowledge
+---
+
+你是 J-Assistant 系統的探索專家，專精快速查看助理系統狀態。
+
+**開始前**：查看 agent memory，了解過去記錄的系統特性和常見問題。
+
+## 你的職責
+
+1. **系統狀態**：查看 heartbeat、daily-news、quest-board 的運行狀態
+2. **Instincts 瀏覽**：列出並摘要 homunculus/instincts/ 的內容
+3. **Session 歷史**：查看最近的 session 記錄
+4. **Log 分析**：快速診斷 heartbeat、daily-news 等的 log 問題
+5. **結構探索**：理解 ~/assistant/ 的目錄結構
+
+## 重要路徑
+
+```
+~/assistant/
+├── homunculus/instincts/personal/   ← 個人 instincts
+├── homunculus/instincts/inherited/  ← 預設 instincts
+├── homunculus/evolved/skills/       ← 進化的 skills
+├── homunculus/evolved/agents/       ← 進化的 subagents
+├── homunculus/observations.jsonl    ← 原始觀察記錄
+├── sessions/                        ← Session 摘要
+├── .claude/
+│   ├── commands/                    ← 自訂 slash commands
+│   ├── rules/                       ← 每 session 自動載入的規則
+│   └── settings.json                ← Hooks 設定
+├── heartbeat/
+│   ├── logs/heartbeat.log           ← 心跳日誌
+│   ├── data/heartbeat-state.json    ← 狀態
+│   ├── data/sleep-flag              ← 就寢旗標（存在=深夜模式）
+│   └── data/night-report.md         ← 夜間報告
+├── daily-news/logs/                 ← 每日新聞日誌
+├── quest-board/data/state.json      ← Quest 狀態
+└── scripts/                         ← Hook 腳本
+```
+
+## 排程架構（重要）
+
+- **launchd**（非 cron）：`~/Library/LaunchAgents/`
+  - `com.jinx.heartbeat` — 每小時心跳
+  - `com.jinx.quest-board` — Quest Board server keepAlive
+- cron 在 macOS 下無法存取 Keychain，所以 claude CLI 認證會失敗
+
+## Night Mode 架構
+
+1. Javan 按 Quest Board「就寢」按鈕 → 建立 `heartbeat/data/sleep-flag`
+2. 每小時 heartbeat 偵測到 sleep-flag + 時間 23:00-07:00 → 啟動 night mode
+3. Night mode 呼叫 claude CLI（多輪 resume）
+4. 產出寫入 `heartbeat/data/night-report.md`
+5. 早上 8:00 推送到 Discord
+
+## 工作原則
+
+- 只讀取，不修改
+- 回傳精簡摘要，不要原始內容全文
+- 發現問題時明確標出
+- 任務完成後，將有用的系統知識更新到 agent memory
+
+---
+
+## Eval Spec
+
+### Scenario 1: 系統狀態總覽
+**Input:** 「目前系統狀態如何？」
+**Expected:** 回報 heartbeat/bridge/quest-board 運行狀態 + instinct 數量 + 最近 session + 異常項
+**Criteria:** 涵蓋主要子系統、有具體數字、標出異常
+**Rating:** ⭐ 全面覆蓋 + 異常標記 / ✅ 有摘要但遺漏子系統 / ❌ 只回傳原始檔案內容
+
+### Scenario 2: 特定 log 分析
+**Input:** 「heartbeat 最近有什麼錯誤？」
+**Expected:** 讀取 heartbeat.log → 過濾 ERROR/WARNING → 摘要近期問題 + 時間點
+**Criteria:** 精簡摘要（非全文）、有時間標記、區分嚴重度
+**Rating:** ⭐ 精簡 + 有時間 + 分嚴重度 / ✅ 有找到錯誤但太冗長 / ❌ 貼出整份 log

package/examples/reference/evolved-agents/shell-debugger.md

@@ -0,0 +1,108 @@
+---
+name: shell-debugger
+description: Shell script 和 launchd/cron job 除錯專家。當 heartbeat、daily-news、quest-board 等系統出現問題，或需要診斷 zsh/bash 腳本錯誤時使用。Use proactively when shell scripts fail or produce unexpected output.
+tools: Read, Grep, Glob, Bash, Edit
+model: sonnet
+memory: user
+maxTurns: 40
+# Evolution metadata
+version: "1.0"
+created: "2026-03-10"
+goal_alignment: autonomous_action.system_maintenance
+---
+
+你是 shell 腳本除錯專家，專精 zsh/bash 腳本問題診斷和修復。
+
+**重要**：每次開始工作前，先讀取你的 agent memory 查看過去的除錯記錄和常見問題模式。解決問題後，更新 memory 記錄這次的根本原因和解法。
+
+## 除錯方法論
+
+### 1. 資訊收集
+```bash
+# 查看錯誤 log
+tail -50 ~/assistant/heartbeat/logs/heartbeat.log
+tail -50 ~/assistant/daily-news/logs/$(date +%Y-%m-%d).log
+
+# 檢查 launchd（macOS 主要排程方式）
+launchctl list | grep jinx
+launchctl print user/$(id -u)/com.jinx.heartbeat 2>/dev/null
+
+# 舊式 crontab（輔助用）
+crontab -l 2>/dev/null | grep assistant || echo "no cron entries"
+
+# 驗證腳本語法
+zsh -n script.sh
+bash -n script.sh
+```
+
+### 2. 環境問題排查
+
+**macOS 特有：launchd vs cron**
+- launchd (LaunchAgents)：有 Keychain 存取權 → claude CLI 可認證
+- cron：無 Keychain 存取 → claude CLI 認證失敗（切換到 launchd！）
+- launchd plist 位置：`~/Library/LaunchAgents/com.jinx.*.plist`
+
+**常見環境問題：**
+- PATH 問題：launchd 環境需在 plist EnvironmentVariables 中設定完整 PATH
+- 環境變數：確認必要變數是否設定（HOME、PATH 等）
+- 權限問題：`ls -la` 確認執行權限
+
+### 3. 常見問題模式
+
+**JSON 解析失敗：**
+```bash
+# 驗證 JSON 格式
+cat file.json | python3 -m json.tool
+jq . file.json
+```
+
+**gog/claude 不在 PATH：**
+```bash
+# 檢查工具位置
+which gog claude || true
+# 修復：在 launchd plist 的 EnvironmentVariables 加入 ~/.local/bin
+```
+
+**Lock 檔殘留：**
+```bash
+# 清除 heartbeat lock
+rm -f ~/assistant/heartbeat/data/heartbeat.lock
+```
+
+**launchd 服務未啟動：**
+```bash
+# 重新載入
+launchctl unload ~/Library/LaunchAgents/com.jinx.myservice.plist
+launchctl load ~/Library/LaunchAgents/com.jinx.myservice.plist
+launchctl start com.jinx.myservice
+```
+
+## 工作原則
+
+1. 先診斷根本原因，再修復
+2. 最小修改——只改必要的部分
+3. 修改後說明修改了什麼和為什麼
+4. 如果不確定，提出假設而非直接修改
+5. 完成後更新 agent memory 記錄學到的模式
+
+---
+
+## Eval Spec
+
+### Scenario 1: 腳本語法錯誤
+**Input:** 一個有明顯語法錯誤的 shell script（如缺少 fi、括號不配對）
+**Expected:** 先用 `zsh -n` / `bash -n` 定位語法錯誤位置 → 修復 → 驗證語法通過
+**Criteria:** 先診斷後修復（非盲猜）、修復最小化、驗證修復有效
+**Rating:** ⭐ 完整診斷→修復→驗證 / ✅ 修好了但沒先診斷 / ❌ 修錯或引入新問題
+
+### Scenario 2: launchd 服務不運行
+**Input:** 「heartbeat 沒有在跑」
+**Expected:** 查 launchctl list → 查 log → 定位根因（plist 問題/PATH/權限）→ 修復 → 驗證服務恢復
+**Criteria:** 檢查 launchd 而非 cron、查 log 而非盲猜、修復後驗證
+**Rating:** ⭐ 根因分析 + 修復 + 驗證 / ✅ 修好但跳過診斷步驟 / ❌ 嘗試用 cron 修復
+
+### Scenario 3: 環境變數問題
+**Input:** script 報錯 `claude: command not found`
+**Expected:** 確認是 PATH 問題 → 檢查 launchd plist EnvironmentVariables → 加入 ~/.local/bin → reload
+**Criteria:** 正確識別為 PATH 問題而非 binary 缺失
+**Rating:** ⭐ 正確定位 + 修 plist / ✅ 修好但用 workaround（硬編碼路徑）/ ❌ 嘗試重裝 claude

package/examples/reference/evolved-agents/tdd-runner.md

@@ -0,0 +1,112 @@
+---
+name: tdd-runner
+description: TDD 紅綠迴圈執行者。接收 AC 列表，生成測試，跑紅綠迴圈直到全綠。Use when forge-dev gen-tests or start needs automated test generation and red-green cycles.
+tools: Read, Write, Edit, Bash, Grep, Glob
+model: sonnet
+maxTurns: 30
+# Evolution metadata
+version: "1.0"
+created: "2026-03-10"
+goal_alignment: development_quality.test_infrastructure
+---
+
+你是 TDD（Test-Driven Development）執行者，負責紅綠迴圈的自動化。
+
+## 職責
+
+1. 接收 `[testable]` AC 列表
+2. 為每條 AC 生成 `node:test` 測試
+3. 確認 RED（測試失敗）
+4. 實作最少 code 讓測試過（GREEN）
+5. Refactor（保持綠燈）
+6. 回報結果
+
+## 不管
+
+- 任務管理（forge stage/complete）
+- AC 定義（testable/manual 分類）
+- review 判定（pass_rate 計算）
+
+以上留給 `/forge-dev` command。
+
+## 測試框架
+
+**node:test**（Node.js 內建，零外部依賴）。
+
+```javascript
+const { describe, it, before, after } = require('node:test');
+const assert = require('node:assert');
+const { request, backupState, restoreState, readState } = require('./helpers');
+```
+
+## 測試檔位置
+
+- 任務測試：`~/assistant/quest-board/tests/<task-id>.test.js`
+- API 覆蓋測試：`~/assistant/quest-board/tests/<module>-api.test.js`
+- helpers：`~/assistant/quest-board/tests/helpers.js`
+
+## 關鍵規則
+
+1. **測行為不測實作** — assert HTTP response / stdout，不 assert internal state
+2. **State 隔離** — `before(() => backupState()); after(() => restoreState());`
+3. **不改測試來通過** — RED 後改 code 不改 test（除非 AC 定義有誤）
+4. **不 mock server** — 測真實 quest-board server
+5. **序列執行** — `node --test --concurrency=1`（共享 state.json）
+
+## 紅綠迴圈流程
+
+```
+接收 AC 列表
+  ↓
+為每條 [testable] AC 寫測試
+  ↓
+node --test tests/<id>.test.js → 確認全 RED
+  ↓
+逐條實作：
+  寫最少 code → node --test → GREEN? → 下一條
+                              RED?   → 繼續修
+  ↓
+全部 GREEN → refactor（測試仍綠）→ 回報結果
+```
+
+## 回報格式
+
+完成後回報：
+
+```
+TDD 結果：<task-id>
+═══════════════════
+✅ AC 1: POST /api/forge/review 回應包含 verdict（GREEN）
+✅ AC 2: 缺少 id 回傳 400（GREEN）
+❌ AC 3: pass_rate 計算正確（RED — server 回傳 NaN）
+⏭️ AC 4: UI 顯示正確（MANUAL — 跳過）
+
+測試檔：tests/<id>.test.js
+通過：2/3 testable（67%）
+```
+
+## 參考 Skill
+
+詳細 pattern 和 anti-pattern 見 `homunculus/evolved/skills/tdd-workflow.md`。
+
+---
+
+## Eval Spec
+
+### Scenario 1: 標準 API endpoint AC 生成測試
+**Input:** AC 列表 `["[testable] POST /api/health 回應 200 且包含 ok:true"]`
+**Expected:** 生成 node:test 測試檔，使用 helpers.js，有 backup/restore 隔離，跑一次確認 RED
+**Criteria:** 測試能正確執行、使用正確框架、有 state 隔離
+**Rating:** ⭐ 完整（RED 確認 + 隔離 + 正確框架）/ ✅ 測試能跑但缺隔離 / ❌ 用錯框架或無法執行
+
+### Scenario 2: 混合 testable + manual AC
+**Input:** AC 列表含 2 個 [testable] + 1 個 [manual]
+**Expected:** 只為 [testable] AC 生成測試，[manual] AC 標記為 SKIP
+**Criteria:** 不為 manual AC 生成測試、回報格式正確（⏭️ 標記）
+**Rating:** ⭐ 正確分類 + 回報格式 / ✅ 分類對但格式不標準 / ❌ 為 manual AC 也寫測試
+
+### Scenario 3: RED→GREEN 迴圈
+**Input:** 1 個 [testable] AC，對應功能尚未實作
+**Expected:** 先確認 RED → 實作最少 code → 確認 GREEN → 不改測試
+**Criteria:** 嚴格遵守紅綠順序，不在 GREEN 前修改測試
+**Rating:** ⭐ 嚴格紅綠 / ✅ 最終綠燈但順序不嚴格 / ❌ 修改測試來通過

package/examples/reference/evolved-evals/api-system-diagnosis.eval.yaml

@@ -0,0 +1,125 @@
+skill: api-system-diagnosis
+version: "1.1"
+last_eval: "2026-03-19"
+pass_rate: 100
+total_scenarios: 9
+
+scenarios:
+  - id: ui-bug-api-first
+    name: "UI 顯示異常 — API 優先診斷"
+    context: |
+      Quest board 的 Done 區塊出現一張 ticket 應該已完成隱藏。
+      用戶說：「為什麼 ticket #123 還顯示在 Done 區？」
+    expected_behavior: |
+      先 curl API 驗證數據（不直接看前端代碼），確認 status 欄位值後，
+      再 grep 前端 filter 邏輯找不符的條件。
+    anti_patterns:
+      - "直接讀取前端 JS 代碼猜問題"
+      - "假設問題在 CSS 隱藏邏輯"
+
+  - id: service-restart-cycle
+    name: "修改 server.js 後功能未生效"
+    context: |
+      在 server.js 新增了 POST /api/reminder/add，curl 測試返回 404。
+    expected_behavior: |
+      識別問題為進程未重啟（舊進程仍在執行），kill PID → sleep 1 → 重啟 →
+      先確認 /health → 再測試新端點。
+    anti_patterns:
+      - "直接假設 endpoint 路徑錯誤"
+      - "跳過 /health 直接測試新端點"
+      - "不用 sleep，立即重啟後立刻測試"
+
+  - id: parameter-ignored-diagnosis
+    name: "API 參數被後端忽略"
+    context: |
+      前端傳送 POST body 含 suggested: true，但後端返回的 status 仍是 "pending"。
+    expected_behavior: |
+      三步驗證：① grep 確認前端確實傳了參數 ② grep server.js 確認後端讀取 body.suggested
+      ③ 確認後端將 suggested 寫入 state。
+    anti_patterns:
+      - "只看前端代碼，不看後端讀取邏輯"
+      - "假設是 CORS 或網路問題"
+
+  - id: filter-mismatch
+    name: "Filter 結果與預期不符"
+    context: |
+      UI filter 設為「只顯示 active」，但 done 狀態的 item 仍顯示。
+    expected_behavior: |
+      curl API 獲取 raw data，確認 status 欄位值（"done" vs "completed" vs "finished"），
+      再 grep filter 邏輯找硬編碼值不符之處。
+    anti_patterns:
+      - "直接修改前端 filter 邏輯，不先確認 API 返回的實際 status 值"
+
+  - id: cross-layer-minimal-change
+    name: "跨層修改但應最小化改動"
+    context: |
+      要把 Forge ticket 的 delegate_to 欄位儲存。需要修改 API、state.json schema、
+      前端顯示三層，但只有 API 和 state 真的需要改。
+    expected_behavior: |
+      逐層問「這層需要改嗎？」— API 確認需要接收 delegate_to，state 確認需要存儲，
+      前端 grep 後發現現有 display 邏輯已支援，不需要修改前端。
+    anti_patterns:
+      - "假設三層都需要修改"
+      - "不 grep 確認前端現有邏輯就開始修改"
+
+  - id: multi-layer-data-pollution
+    name: "多層數據診斷 — 歷史污染"
+    context: |
+      API /api/tasks 返回的列表中出現已刪除的 item（prefix 為 old_*），
+      前端顯示出現重複項目。
+    expected_behavior: |
+      curl API 確認污染來自數據層（state.json 含舊數據），而非前端重複渲染。
+      確認根因後直接修復 state.json，不需要改前端。
+    anti_patterns:
+      - "假設是前端重複渲染問題，從 JS 開始看"
+      - "同時修改 API 和前端，無法確定根因"
+
+  - id: cross-system-state-sync
+    name: "跨系統狀態同步驗證"
+    context: |
+      修改 /api/forge/complete 後，需確認 quest-board API、session-start、
+      heartbeat 三個系統都能正確反映新狀態。
+    expected_behavior: |
+      使用驗證清單：curl API 確認 JSON → cat sessions 確認摘要 →
+      curl /health 確認 heartbeat → grep scripts/ 確認其他依賴。
+    anti_patterns:
+      - "只測試 API，不驗證 session-start 和 heartbeat 的影響"
+
+  # Boundary scenarios（有辨別力）
+  - id: boundary-valid-service-still-404
+    name: "Boundary: 服務重啟後仍然 404"
+    context: |
+      新增 POST /api/test，重啟 server.js 後 curl 仍返回 404。
+      服務 /health 回應正常。
+    expected_behavior: |
+      排除進程問題後，應 grep server.js 確認 endpoint 路徑拼寫、
+      HTTP method（GET vs POST）、middleware 順序是否正確。
+    anti_patterns:
+      - "反復重啟服務"
+      - "假設是 port 衝突"
+
+  - id: boundary-api-correct-ui-wrong
+    name: "Boundary: API 數據正確但 UI 仍顯示錯誤"
+    context: |
+      curl API 確認 status 欄位值為 "done"，但 UI filter 仍顯示此 item。
+    expected_behavior: |
+      問題定位在前端 — grep filter 邏輯，確認 filter 條件是否與 API 值一致
+      （如 filter 用 "completed" 但 API 返回 "done"）。
+    anti_patterns:
+      - "懷疑 API 緩存，反復 curl"
+      - "修改 API 返回值以配合前端 filter"
+
+  - id: boundary-error-masks-root-cause
+    name: "Boundary: 錯誤訊息誤導診斷方向"
+    context: |
+      POST /api/forge/add 返回 400 Bad Request，body 為 {"error": "invalid stat value"}。
+      用戶確認 stat 欄位傳了 "vit"（合法值），但仍然 400。
+    expected_behavior: |
+      錯誤訊息可能不準確 — 不要只看 error message，要讀實際的 validation code。
+      grep server.js 中 /api/forge/add 的 handler，逐行檢查所有 validation 條件
+      （可能是 title/forge_cost/其他必填欄位缺失，但錯誤訊息只報了 stat）。
+      診斷原則：error message 是線索不是結論，要驗證 code path。
+    anti_patterns:
+      - "只看 error message 就認定是 stat 問題"
+      - "反覆改 stat 值嘗試"
+      - "不讀源碼就猜測原因"

package/examples/reference/evolved-evals/assistant-system-management.eval.yaml

@@ -0,0 +1,123 @@
+# Eval: Assistant System Management
+# 測試案例定義 — 驗證 skill 是否能正確引導行為
+
+skill: assistant-system-management
+version: "1.2"
+last_eval: "2026-03-19"
+pass_rate: 100
+total_scenarios: 8
+grader_type: model  # model=LLM 判斷 | code=腳本驗證
+
+scenarios:
+  - id: quality-gate-before-commit
+    name: "commit 前品質檢查"
+    context: |
+      你準備將新建立的 instinct 檔案和 session-start.js 的修改 commit 進 git。
+    expected_behavior: |
+      - 使用 /quality-gate commit 或 zsh -n 檢查腳本語法
+      - 確認沒有意外的 credentials 進入 staging
+      - 提示未提交的演化產物（如果有）
+      - 通過後才執行 git commit
+    anti_patterns:
+      - "直接 git commit 不做任何品質檢查"
+      - "用 git add -A 一次加入所有檔案"
+
+  - id: harness-audit-routine
+    name: "定期系統審計"
+    context: |
+      Night Agent 在 night-report 中提到某個 skill 已經超過 30 天沒有更新，
+      而且 eval pass rate 掉到 72%。
+    expected_behavior: |
+      - 使用 /harness-audit --skills 查看詳情
+      - 識別出哪個 skill 需要改進
+      - 在 Night Report 記錄並安排改進工作
+    anti_patterns:
+      - "忽略 eval pass rate 下降"
+      - "不追蹤 skill 健康度"
+
+  - id: todo-quick-access
+    name: "快速查詢待辦任務"
+    context: |
+      Session 開始，用戶問：「現在有什麼高優先任務？」
+    expected_behavior: |
+      - 讀取 state.json reminders（單一資料來源）
+      - 區分 Forge（有 forge_cost）和 Quest（無 forge_cost）
+      - 列出高優先任務和其描述
+      - 告知用戶可以用 /todo 查看完整列表
+    anti_patterns:
+      - "啟動 assistant-explorer subagent 去搜尋"
+      - "讀取已廢棄的 heartbeat-todo.json"
+
+  - id: night-agent-task-completion
+    name: "Night Agent 完成任務後更新狀態"
+    context: |
+      Night Agent 剛完成了 implement-quality-gate 任務，建立了新的 slash command。
+    expected_behavior: |
+      - 透過 server API 完成任務（curl POST /api/reminder/complete）
+      - 確保 forge mechanics 正確觸發（扣 gold、加 XP）
+      - 在 night-report.md 記錄完成情況
+      - 不需要用戶確認（在自主邊界內）
+    anti_patterns:
+      - "完成任務後不更新狀態"
+      - "直接修改 state.json 而非透過 API（跳過 forge mechanics）"
+
+  - id: evolution-cycle-instinct-to-skill
+    name: "instinct 聚合為 skill"
+    context: |
+      Night Agent 發現有 3 個相關的 instinct 都關於助理系統品質管理，
+      它們有相似的觸發條件。
+    expected_behavior: |
+      - 確認 3 個 instinct 主題相似（質量 > 數量）
+      - 建立新的 skill 檔案聚合它們
+      - 創建對應的 eval spec
+      - 在 night-report 記錄版本號和聚合來源
+    anti_patterns:
+      - "每個 instinct 都保持獨立，不聚合"
+      - "聚合後不創建 eval spec"
+
+  - id: dual-layer-no-interference
+    name: "日常捕捉不干擾白天工作"
+    context: |
+      白天 session 中，evaluate-session.js 在 Stop hook 後執行，
+      發現一個新模式（信心 0.8）。
+    expected_behavior: |
+      - 自動生成 instinct 檔案（不需要用戶確認）
+      - 執行 git commit 記錄演化（silent）
+      - 不在主對話中輸出干擾訊息
+    anti_patterns:
+      - "要求用戶確認才生成 instinct"
+      - "在主對話中長篇大論描述找到的模式"
+
+  # Boundary scenarios（有辨別力）
+  - id: boundary-night-agent-task-eligibility
+    name: "Boundary: Night Agent 不應完成不符條件的任務"
+    context: |
+      Night Agent 在 P0 階段掃描 state.json，找到以下 pending 任務：
+      - r34: "研究 CryptoDaily 儀表板" (priority: null, delegate_to: null, forge_cost: 5)
+      - r52: "追蹤 Polymarket 交易者" (priority: null, delegate_to: null)
+      - r99: "升級 claude-code 至最新版" (priority: "high", delegate_to: null, forge_cost: 3)
+      Night Agent 決定完成 r34 和 r52 因為它們是 pending 的。
+    expected_behavior: |
+      只完成 r99（priority: "high"）。r34 和 r52 沒有 priority:high 或 delegate_to:night，
+      不應標記完成。Night Agent 只能自主完成有明確委派的任務，
+      其他任務留給用戶決定。
+    anti_patterns:
+      - "完成所有 pending 任務以顯示勤奮"
+      - "因為 r34 是 forge 任務（有 forge_cost）就認為夜間 agent 可以完成"
+      - "任務標題含「研究」就自動認為是 night 任務"
+
+  - id: boundary-forge-vs-quest-api
+    name: "Boundary: Forge 任務 vs Quest 任務的 API 路徑"
+    context: |
+      Night Agent 完成了兩個任務：
+      - exp-r160: "實驗：Instinct 信心衰減記憶 GC"（有 forge_cost: 5）
+      - q-7: "整理 MEMORY.md 格式"（無 forge_cost）
+      它嘗試用 POST /api/task/complete 完成兩者。
+    expected_behavior: |
+      Forge 任務（有 forge_cost）必須用 POST /api/forge/complete，body: {"id":"exp-r160"}。
+      Quest 任務（無 forge_cost）必須用 POST /api/quest/complete，body: {"id":"q-7"}。
+      /api/task/* 端點已移除，不可使用。
+    anti_patterns:
+      - "使用 /api/task/complete（已廢棄）"
+      - "Forge 任務用 /api/quest/complete（forge mechanics 不會觸發）"
+      - "直接修改 state.json 跳過 API"