uncle6me-web
5d00e71275
頂層 D22 決策（leo 2026-07-03 拍板）：推什麼由開發環境歸屬決定， Gitea private＝除機敏值/build 產物/.github 外全 push。 解 T1.5 卡點：雲端工人 clone 拿得到 credential-store-migration.md，可就地改寫 SDD。 機敏掃描兩輪通過（新增 189 檔約 2.1MB，node_modules/dist/wasm 照舊排除）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
# Arcrun 文件分類索引
|
||
|
||
> LLM Wiki 結構：長期記憶系統，防止決策遺忘和重複錯誤。
|
||
> 參考：[Andrej Karpathy — A Closer Look at How LLMs Remember](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
|
||
|
||
---
|
||
|
||
## 分類規則
|
||
|
||
| 目錄 | 用途 | 例子 |
|
||
|------|------|------|
|
||
| **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 的長期記憶入口。
|