Leo
ecf1f882c6
工具產物原散在用戶根目錄(docs 七層、scripts),又把 wiki/VERSION 寄生在 CC 原生
.claude/ 裡,用戶分不清哪個 docs 是工具的。這版徹底收斂:除 .claude/(settings/
commands/hooks)與 CLAUDE.md 留根,工具所有資料收進 system-dev/。
對應 SDD: system-dev/docs/3-specs/install-layout/(內部記錄,依原則不推)。
- 新結構 system-dev/{VERSION,wiki/,docs/,scripts/};.claude/ 只剩 CC 機制檔
- wiki 改寫產物落點正式化:install 建 system-dev/wiki/cards/(.gitkeep)
- docs 雙語義拆開:工具文件→system-dev/docs/;用戶 raw source 維持原處只讀
- scripts 一開始就裝進 system-dev/scripts/
- 舊版自動遷移雙保險:update.sh 冪等搬移(wiki 含 .git、docs 白名單)
+ session-start hook 偵測舊結構未遷移時提示(low-code 用戶兜底)
- wiki-secret-scan 觸發路徑改 system-dev/wiki/**(否則新結構防護失效)
- 全套路徑引用同步:CLAUDE/SKILL/wiki-*/sdd-*/hooks/INDEX/README(中英)
- 沙盒驗證:遷移含 .git commit 一致、冪等、用戶自填 docs 保留;全 bash -n 過
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.5 KiB
1.5 KiB
system-dev/wiki/ — LLM 記憶系統
新 session 開始時從這裡導航。 目的：讓 CC 不需要重新學習已知的事。 維護者：CC（人不手動編輯這裡）
核心檔案
| 檔案 | 何時讀 | 內容 |
|---|---|---|
status.md |
session 開始第一件事 | 當前進度、下一步 |
mistakes.md |
做新功能前 | 已知誤解、快速檢查清單 |
decisions-summary.md |
遇到設計判斷時 | 架構決策摘要 |
維護規則
- 只增不刪——記錄 append，決策改了加新條目說明「舊決策已更新」
- status.md 每次 session 結束更新
- mistakes.md 每次被糾正後 append
- 發現新的重要決策 → 同時更新 decisions-summary.md 和 system-dev/docs/2-architecture/decisions/
頂層索引：標籤視圖（由 /wiki-init 填入）
由 CC 改寫原文後填入。原文是唯讀 SSoT，wiki 是改寫過的記憶。
頂層 INDEX 是標籤視圖（非資料夾列表），按 TAXONOMY.md 的軸聚類，指向各桶子索引：
### 知識管理
- [[pkm/00-INDEX]] — PKM 知識管理（N 卡）
### AI 協作
- [[ai/00-INDEX]] — AI 協作（M 卡）
結構：頂層 INDEX（標籤視圖）→
cards/<bucket>/00-INDEX.md（桶子索引，固定名）→ 概念原子卡。 指00-INDEX一律帶路徑[[bucket/00-INDEX]]（固定名跨桶撞名）；卡片間用裸[[卡名]]。 分類由卡片 frontmattertags:承載，標籤字典見TAXONOMY.md。詳見/wiki-init規範。