開始新專案？
├─ Yes → 執行 'go init'（互動式 MVP 規劃）
│   ├─ AI 問 5 個問題
│   ├─ 自動產生 MVP 計畫
│   ├─ 建立 TODO.md
│   └─ 執行 'go' 開始開發
│
└─ 現有專案 / 已有部分程式碼？
    ├─ 手動建立 TODO.md（參考 references/TODO.template.md）
    ├─ 標記已完成的任務
    └─ 執行 'go' 繼續開發

步驟 1：初始化專案
使用者：go init

步驟 2：回答 5 個問題
- 專案目標
- 目標使用者
- 核心功能（AI 會幫你篩選出 MVP）
- 技術堆疊
- 預計時程

步驟 3：確認 MVP 計畫
- 核心功能：3-5 個
- 預估時程：1-2 週
- 模組數量：3-5 個

步驟 4：開始開發
使用者：go

步驟 1：建立 TODO.md
複製範本：cp references/TODO.template.md TODO.md

步驟 2：編輯 TODO.md
- 標記當前階段（加 🔄）
- 標記已完成任務（[x]）
- 標記已完成階段（加 ✅）

步驟 3：開始使用
使用者：go

✅ 必要（MVP）：沒有此功能，產品無法運作
   範例：任務管理 App 的「建立任務」「標記完成」

⚠️ 重要（v1.1）：有會更好，但不是必需
   範例：「設定截止日期」「任務分類」

⏳ 有用（v1.2）：提升便利性
   範例：「搜尋任務」「篩選排序」

❌ 額外（v2.0）：Nice-to-have
   範例：「附件上傳」「團隊協作」

// auth.types.ts - 只有 50 行
export interface AuthService {
  login(credentials: LoginRequest): Promise<AuthSession>
  logout(sessionId: string): Promise<boolean>
}

// auth.service.ts - 200 行實作細節（不需要全部載入）

✅ 優秀：
src/features/auth/
  auth.types.ts        # 50 行
  auth.service.ts      # 200 行
  auth.controller.ts   # 100 行

❌ 不好：
src/services.ts        # 2000 行（所有服務混在一起）

Phase 1: Planning (10-20% 時間)
  ├─ 架構設計
  ├─ 模組邊界定義
  ├─ 介面定義（Interface First）
  └─ 資料庫設計

Phase 2: Backend Development (30-35% 時間)
  ├─ 資料庫模組
  ├─ 業務邏輯模組
  ├─ API 端點
  └─ 錯誤處理

Phase 3: Frontend Development (25-30% 時間)
  ├─ API 客戶端
  ├─ 核心元件
  ├─ 狀態管理
  └─ 基本樣式

Phase 4: Testing (15-20% 時間)
  ├─ 單元測試
  ├─ 整合測試
  └─ 基本 E2E 測試

Phase 5: Deployment (5-10% 時間)
  ├─ Docker 容器化
  ├─ CI/CD 設定
  └─ 正式環境部署

✅ 載入：
- docs/architecture.md（當前模組部分）
- src/models/[current-module].types.ts
- src/services/[current-module].ts

❌ 不載入：
- 其他模組的實作細節
- 前端檔案
- 測試檔案

📍 當前階段：Backend Development (Phase 2) 🔄

進度：2/5 任務完成（40%）

✅ 已完成：
- Database schema
- Core API endpoints

⏳ 待辦：
- Authentication system
- Error handling
- Module interfaces documentation

下一個任務：Authentication system

✅ 任務完成：Authentication system

建議的 commit：
───────────────────────────────────
feat(auth): implement JWT authentication module

- Add JWT token generation and validation
- Implement login/logout endpoints
- Create auth middleware for route protection
- Define AuthService interface in auth.types.ts

Files changed: 4 (auth module only)
Total: 420 lines

Closes #12
───────────────────────────────────

繼續提交？（yes/edit/skip）

<type>(<scope>): <subject>

[optional body]

[optional footer]

🎉 Phase 2: Backend Development 完成！

所有任務已完成：
  ✅ Database schema
  ✅ Core API endpoints
  ✅ Authentication system
  ✅ Error handling
  ✅ Module interfaces documentation

模組化品質檢查：
  ✅ 5/5 模組有清楚的介面定義
  ✅ 跨模組依賴皆透過介面
  ✅ 每個模組皆可獨立測試

準備進入 Phase 3: Frontend Development？（yes/no）

src/features/auth/
  auth.types.ts          # 30-50 行 - 公開介面
  auth.service.ts        # 150-200 行 - 核心邏輯
  auth.controller.ts     # 80-100 行 - API 端點
  auth.test.ts           # 150-200 行 - 測試
  README.md              # 30-50 行 - 使用說明
  internals/             # 內部實作（非公開）
    jwt.helper.ts
    password.helper.ts

// task.types.ts - 僅 30-50 行
export interface TaskService {
  createTask(data: CreateTaskRequest): Promise<Task>
  getTasks(userId: string): Promise<Task[]>
  updateTaskStatus(taskId: string, completed: boolean): Promise<Task>
  deleteTask(taskId: string): Promise<boolean>
}

export interface Task {
  id: string
  title: string
  description?: string
  completed: boolean
  userId: string
  createdAt: Date
  updatedAt: Date
}

export interface CreateTaskRequest {
  title: string
  description?: string
  userId: string
}

📊 模組化健康度報告

檔案大小分布：
  ✅ 90% 檔案 < 300 行
  ⚠️  2 個檔案 > 500 行（建議拆分）

模組耦合度：
  ✅ auth: 獨立性高
  ⚠️  user ↔ notification: 耦合過緊

介面覆蓋率：
  ✅ 8/10 模組有 .types.ts
  ❌ analytics 缺少介面定義

Token 效率：
  當前：~400 行/任務
  優化後：~250 行/任務（提升 37.5%）

建議重構：
  1. 拆分 src/legacy/api.ts（850 行）
  2. 為 analytics 建立介面定義
  3. 解耦 user 和 notification