CLAUDE.md

1# CLAUDE.md - Claude Code 專案指引
2 
3此文件為 Claude Code（Anthropic 的 AI 編程助手）提供專案上下文。
4當使用 Claude Code 時，它會自動讀取此文件以了解專案規範。
5 
6---
7 
8## 專案概述
9 
10這是一個 **AI 輔助開發專案模板**，整合了：
11- 憲法-子法層級規則系統
12- Claude Skills 模組化技能
13- Memory Bank 專案記憶
14- DDD + DAL 獨立架構
15 
16## 法規層級
17 
18```
19CONSTITUTION.md          ← 最高原則（不可違反）
20  │
21  ├── .github/bylaws/    ← 子法（細則規範）
22  │     ├── ddd-architecture.md
23  │     ├── git-workflow.md
24  │     └── memory-bank.md
25  │
26  └── .claude/skills/    ← 實施細則（操作程序）
27```
28 
29## 核心原則
30 
31### 0. 開發哲學 💡
32> **「想要寫文件的時候，就更新 Memory Bank 吧！」**
33> 
34> **「想要零散測試的時候，就寫測試檔案進 tests/ 資料夾吧！」**
35 
36- 不要另開檔案寫筆記，直接寫進 Memory Bank
37- 今天的零散測試，就是明天的回歸測試
38 
39### 1. DDD 架構
40- Domain Layer 不依賴外部
41- DAL (Data Access Layer) 必須獨立
42- 使用 Repository Pattern
43- 參見：`.github/bylaws/ddd-architecture.md`
44 
45### 2. Python 環境（uv 優先）
46```bash
47# 初始化
48uv venv && uv sync --all-extras
49 
50# 安裝依賴
51uv add package-name
52uv add --dev pytest ruff mypy
53```
54- 參見：`.github/bylaws/python-environment.md`
55 
56### 3. Memory Bank 同步
57每次重要操作必須更新：
58- `memory-bank/progress.md` - 進度追蹤
59- `memory-bank/activeContext.md` - 當前焦點
60- `memory-bank/decisionLog.md` - 重要決策
61 
62### 4. Git 工作流
63提交前執行檢查清單：
641. Memory Bank 同步
652. README 更新（如需要）
663. CHANGELOG 更新
674. ROADMAP 標記
68 
69## 可用 Skills
70 
71| Skill | 用途 |
72|-------|------|
73| `git-precommit` | Git 提交前編排器 |
74| `ddd-architect` | DDD 架構輔助 |
75| `code-refactor` | 主動重構與模組化 |
76| `memory-updater` | Memory Bank 同步 |
77| `memory-checkpoint` | 記憶檢查點（Summarize 前外部化） |
78| `readme-updater` | README 智能更新 |
79| `changelog-updater` | CHANGELOG 自動更新 |
80| `roadmap-updater` | ROADMAP 狀態追蹤 |
81| `code-reviewer` | 程式碼審查 |
82| `test-generator` | 測試生成（Unit/Integration/E2E） |
83| `project-init` | 專案初始化 |
84 
85## 💸 Memory Checkpoint 規則
86 
87### 主動觸發時機
88- 對話超過 **10 輪** 時，主動建議 checkpoint
89- 完成 **重大功能** 後，主動執行 checkpoint
90- 使用者說要 **離開/等等繼續** 時，主動執行 checkpoint
91 
92### Checkpoint 內容必須包含
93- 具體檔案路徑
94- 變更摘要
95- 下一步計畫
96- 重要決策（如有）
97 
98### 觸發指令
99```
100「記憶檢查點」 / 「checkpoint」 / 「存檔」
101「保存記憶」 / 「sync memory」
102```
103 
104## 常用指令
105 
106```
107「準備 commit」       → 執行完整提交流程
108「快速 commit」       → 只同步 Memory Bank
109「建立新功能 X」      → 生成 DDD 結構
110「review 程式碼」     → 程式碼審查
111「更新 memory bank」  → 同步專案記憶
112```
113 
114## 目錄結構約定
115 
116```
117src/
118├── Domain/           # 核心領域（無外部依賴）
119├── Application/      # 應用層（用例編排）
120├── Infrastructure/   # 基礎設施（DAL、外部服務）
121└── Presentation/     # 呈現層（API、UI）
122```
123 
124## 注意事項
125 
126- 修改程式碼前先更新規格文檔
127- 程式碼是文檔的「編譯產物」
128- 遵循 Conventional Commits 格式
129- 使用繁體中文回應
130