Leo
06e901f590
把 system-dev-template 1.9.x 的知識庫基建搬進 git（從功能 PR 拆出，獨立成筆）： - system-dev/wiki/：LLM 記憶系統（principles 鐵律 + 5 張 ingest 卡 + INDEX/TAXONOMY + status/mistakes） - system-dev/docs/：SDD 新家（3-specs/ + 2-architecture/ + README/SKILL）；ingest-pipeline SDD 從 docs/3-specs/ 搬來 - system-dev/scripts/：install/update - .claude/：wiki/SDD harness（commands + hooks：session-recall / sdd-guard / wiki-secret-scan） SDD 位置統一：docs/3-specs/ingest-pipeline → system-dev/docs/3-specs/ingest-pipeline （對齊 SDD guard hook 預期路徑 + template 1.9.x 規約）。 純基建遷移，不含任何功能程式碼（src/tests/contracts 在功能 PR #3）。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
# 文件分類索引
|
|
|
|
> CC 整理文件時的分類依據。找不到分類就問，不要猜。
|
|
|
|
---
|
|
|
|
## 分類規則
|
|
|
|
| 目錄 | 放什麼 | 判斷標準 |
|
|
|------|--------|---------|
|
|
| **1-vision/** | 為什麼做這個 | 產品願景、北極星、設計哲學 |
|
|
| **2-architecture/** | 系統怎麼設計的 | 架構圖、技術棧、元件關係 |
|
|
| **2-architecture/decisions/** | 為什麼這樣設計 | ADR，選A不選B的原因 |
|
|
| **3-specs/** | 要做什麼 | SDD，每個子系統一個目錄 |
|
|
| **4-guides/** | 怎麼做 | 部署、開發流程、CLI 用法 |
|
|
| **5-records/** | 發生過什麼 | 歷史記錄，不修改只增加 |
|
|
| **5-records/incidents/** | 生產問題復盤 | 故障原因、時間線、改進方案 |
|
|
| **5-records/test-reports/** | 測試結果 | 壓測報告、驗收記錄 |
|
|
| **6-user/** | 給使用者看的 | README、安裝教學、FAQ |
|
|
|
|
---
|
|
|
|
## CC 整理文件時的判斷流程
|
|
|
|
```
|
|
這個文件是...
|
|
├── 有明確子系統 + 設計內容？ → docs/3-specs/[子系統]/
|
|
├── 解釋為什麼做某個決定？ → docs/2-architecture/decisions/
|
|
├── 說明怎麼操作？ → docs/4-guides/
|
|
├── 記錄發生過的事？ → docs/5-records/
|
|
├── 給外部使用者看的？ → docs/6-user/
|
|
└── 以上都不確定？ → 列為「待確認」，問負責人
|
|
```
|
|
|
|
---
|
|
|
|
## SDD 結構（docs/3-specs/ 下每個子系統）
|
|
|
|
```
|
|
docs/3-specs/[子系統名]/
|
|
├── design.md ← 設計文件（要做什麼、怎麼做、邊界在哪）
|
|
└── tasks.md ← 任務清單（[ ] 未開始 [🔄] 進行中 [x] 完成）
|
|
```
|
|
|
|
CC 動手前必須有這兩個檔案。找不到就停手。
|
|
|
|
---
|
|
|
|
## .claude/wiki/ — CC 的記憶空間（CC 維護，人不手動編輯）
|
|
|
|
| 檔案 | 用途 | 更新時機 |
|
|
|------|------|---------|
|
|
| `INDEX.md` | wiki 導引 | 新增 wiki 檔案時 |
|
|
| `mistakes.md` | CC 已知誤解 + 避坑 | 每次被糾正後 |
|
|
| `status.md` | 當前進度 + 下一步 | 每次 session 結束 |
|
|
| `decisions-summary.md` | 架構決策摘要 | 重大決策後 |
|