5cadc60e36
📋 SDD:workflow-discovery(本 commit 同時執行 D35 交接:portal-auth 26/26 完成 → closed superseded_by workflow-discovery;workflow-discovery paused → active。單一活性已驗=1 份) 🎯 對應 task:3.x 搜尋端誠實化(CP2-B) 病灶(leo 2026-07-30 定性「腹語術」): search-nodes.ts 無條件回 status:'found'、missingNodes 永遠 []—— 型別宣告了 'missing' 但程式碼從不使用。實測「完全不存在的東西xyz」也回 found。 ⇒ AI 拿到假信號 → 以為零件存在 → 部署才發現沒有 → 改寫 code ⇒ 正式 workflow 只用 2 個零件、8 個 code 節點含 if×61。 修法: - 查 registry 判真實存在(走 HTTP,守 D28 禁新增 service binding; URL 用既有 wasmWorkerUrl() 慣例組,不自創) - found 時附 input_schema/success_rate/stability ⇒ AI 才填得出 payload、才看得到「測過幾次」(leo:AI 只要填 payload) - 查不通回 'unknown' 而非 'missing'——**誠實限制**: 不能因查詢失敗就宣告零件不存在(那會讓 AI 誤判而重寫 code) - missing 真的回傳出去(原本寫死 []) ⚠️ 實測發現 registry **沒有列表端點**(GET /components → 404,只有 /components/<id>) ⇒ 改為逐個查(節點數通常 <10、5s timeout)。補列表端點後可改抓一次=CP2-B 待辦。 驗:tsc 零錯誤;vitest 9 failed/179 passed=**與改動前 stash 對帳完全相同**(既有債非本次造成)。 ⏳ 待部署到實例後跑 arcrun-usable/verify.sh 驗 01 那組轉綠。
Arcrun 文件分類索引
LLM Wiki 結構:長期記憶系統,防止決策遺忘和重複錯誤。 參考:Andrej Karpathy — A Closer Look at How LLMs Remember
分類規則
| 目錄 | 用途 | 例子 |
|---|---|---|
| 1-vision/ | 「為什麼」:設計哲學、核心價值、前瞻方向 | arcrun 優勢、Haiku 就能搞定、薄殼原則 |
| 2-architecture/ | 「是什麼」:系統設計、技術棧、組件關係 | MVP 架構、零件模型、KV 存儲方案 |
| 2-architecture/decisions/ | 架構關鍵決策和 trade-off | Service binding 為什麼廢、R2 只用 Phase 5、同 zone 1042 解法 |
| 3-specs/ | 需求和 SDD:設計文件、任務清單 | (從 .agents/specs/ 搬來) |
| 4-guides/ | 操作手冊:如何做、工作流程 | 部署流程、CLI 用法、壓測方法 |
| 5-records/ | 日誌和證據:事件、測試、決策履歷 | Incident、壓測報告、問題追蹤 |
| 5-records/incidents/ | 生產問題復盤:故障原因、改進方案 | 2026-05-13 同 zone 1042、2026-06-06 MCP route bug |
| 5-records/test-reports/ | 壓測結果、驗收報告 | 2026-06-07 公庫上線測試、2026-06-08 Haiku 乾淨重測 |
| 6-user/ | 對外文件:README、教程、FAQ | self-hosted 安裝、開發者指南 |
.claude/wiki/ — LLM 本機記憶
| 檔案 | 用途 | 更新頻率 |
|---|---|---|
| INDEX.md | wiki 目錄和導引 | 每次新增 |
| mistakes.md | CC(我)常犯的錯 + 避坑方法 | 每次踩坑後 |
| status.md | 當前進度、已知問題、下一步 | 每次 session 結束 |
| decisions-summary.md | 架構決策快速參考(不是全文,是摘要 + 連結) | 每次大決策後 |
| modules/[name].md | 關鍵模組說明:職責、入口、常見誤解 | 不定期補充 |
檔案遷移計畫
| 當前位置 | 新位置 | 優先級 |
|---|---|---|
| 根目錄 .md(除 README/CLAUDE) | → docs/ 分類 | 高 |
| .agents/specs/ | → docs/3-specs/ | 高 |
| .claude/rules/ | → docs/2-architecture/ + wiki | 中 |
| docs/incidents/ | → docs/5-records/incidents/ | 中 |
| 壓測報告 | → docs/5-records/test-reports/ | 中 |
下一步
所有檔案整理進此結構後,wiki 將作為 CC 和任何 LLM 的長期記憶入口。