Files
Arcrun/system-dev/docs
Leo df62933fa5 docs(spec): artifact-sharing leo 三補點 — deps_summary 搜尋層可見 + author 信譽經濟 + 資料完整性優先於界面
leo review 方向確認後的三個補點(2026-07-07,總管轉達):

1. deps_summary:搜尋結果每項就顯示配套需求(從 dependency_manifest 聚合的輕量摘要,
   submit 時算好存 metadata_json)。low-code 關鍵:判斷「裝不裝」的資訊要在搜尋層,
   不是 pull 之後才發現缺東西。design(R1 模型/端點/R5/驗收)、requirements(US-4/R3)、
   tasks(1.1/1.2/2.2)對應補。
2. author 信譽經濟(market 核心):author= 過濾+作者頁端點(找到 Leo 看到他全部 shares);
   author_reputation=從 per-uuid stat 聚合的衍生視圖、不另立真相源(第一階段查詢時算、
   量大再物化);選版升級為單品+作者信譽複合分(權重待拍板);獎勵層 future 不實作
   (第一階段獎勵=信譽本身;author 綁認證身份列 SaaS/多人市場前置)。design(作者信譽段/
   端點/待拍板 6-8)、requirements(US-9/R3)、tasks(1.3/1.6/5.4/5.5)。
3. 資料完整性優先於界面:新增設計原則段(UI 是未來的皮、record 完整性是現在的責任;
   事件型資料事後不可重建 → pull/submit 事件 day-one append);record 欄位用「未來
   showcase 網站」反推補齊(created_at/updated_at/tags/compat/license,各標必填/自記/可選);
   驗收加可測定義:不看 UI 僅用 record+事件就能重建市場首頁(作者榜/熱門榜/最新發布/配套需求)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
2026-07-07 10:15:52 +00: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 的長期記憶入口。