Files
Arcrun/system-dev/docs
uncle6me-web 46afea83c2 步驟1 最後一筆:install-harness 交付內容升級到現世代+世代閘
管道本來就是好的(install-harness 功能完整、冪等),**過時的是內容**:
harness skill(4066B)grep「意圖」「>>」= 0 命中,只講世界觀/別寫 Python
⇒ 新裝的封測者拿不到步驟 1 的核心教材(`>>` 意圖語法)。

■ 單一真相源:harness skill 改為建置期由 registry 複製
  build-harness-skill.mjs=head + registry/skills/write_intent_workflow.md 正文 + tail。
  選「建置期複製」的理由:npm files 只收 harness/,registry 不進套件;
  symlink 在 npm pack 與 Windows 不可靠。產物 commit 進 repo(npm 裝的是產物、不跑 build)。
  head/tail 是 harness 專屬(CLI 語境入口/acr 指令表/暴露同意/誠實鐵律),
  install-harness 的 copyTree 跳過 .head/.tail,不鋪進使用者專案。

■ 其餘三件逐份對照現世代事實後更新(過時的直接刪,不留死代碼)
  - CLAUDE.block.md:補 >> 意圖語法、not_found 兩條路、零件 vs recipe 分型、
    腹語術紅線、金鑰只拿名字
  - commands/arcrun.md:步驟改成「先寫意圖 → 丟去查 → 再寫 YAML」,補 acr search/validate
  - hooks/arcrun-guard.sh:**正路提示改為指向 arcrun-mindset Skill +意圖語法**
    (呼應「hook 沒提 skill 反而把 AI 導向 repo 文件」的教訓);
    新增 code 節點腹語術提醒,settings.fragment 補 Write|Edit|MultiEdit matcher

■ 世代閘(防再度脫節)
  check-harness-generation.mjs 檢查四件交付物的現世代指紋,缺指紋 exit 1,
  掛進 npm run build(prepublishOnly 因此也擋)。
  反向驗證:把 skill/CLAUDE.block 換回上一代 → 兩者都被擋下並逐條點名缺哪個指紋。

■ 驗收(考生 haiku/受測物=環境)
  乾淨臨時目錄 acr install-harness → 四件鋪好;重跑冪等(全檔 md5 不變、
  CLAUDE.md 66 行不變、hooks 條目 2 不變、arcrun 區塊仍 1 個)。
  haiku 只讀該目錄的 CLAUDE.md+SKILL.md(明令禁讀 ~/.claude、禁上網;
  兩份教材 md5 與大小均不同,可證非考本機那支)答十題
  → grade-step1.sh **10 / 10 通過**(判分器同時反向驗證仍會抓
  ON_TRUE/ON_FAILURE/第一節點非 input)。
  npm test 18/18、tsc 綠。

SDD:workflow-discovery/tasks.md 3.11

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-31 15:29:17 +08:00
..

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 的長期記憶入口。