Claude Code: Coding Plan

# 方法1：/plan コマンド
> /plan Migrate auth from Session to JWT

# 方法2：指示に「plan first」を含める
> Migrate auth from Session to JWT, plan first then execute

# 方法3：自動トリガー（大規模タスク）
> Refactor entire project's error handling

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Coding Plan: Session → JWT Auth Migration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## Goal
認証を Session から JWT に移行

## Impact Scope
- Modified files: 12
- New files: 3
- Deleted files: 2
- DB changes: None

## Execution Steps

### Step 1: Create JWT utility module
- New src/auth/jwt.ts
- Implement token generation, verification, refresh
- Write unit tests

### Step 2: Modify auth middleware
- Modify src/middleware/auth.ts
- Change from Session to JWT verification
- Keep interface unchanged

### Step 3: Modify login/register routes
- Modify src/routes/auth.ts
- Return JWT token instead of setting Session

### Step 4: Modify protected routes
- Modify 8 route files
- Adjust auth check method

### Step 5: Clean up Session code
- Delete session config
- Remove express-session dependency

## Risk Assessment
- 🔴 High: ミドルウェアの移行はすべてのログインユーザーに影響する可能性
- 🟡 Medium: Token リフレッシュロジックは慎重な設計が必要
- 🟢 Low: ユーティリティモジュールは独立しており、既存コードに影響なし

## Estimate
- Tokens: ~80K
- Time: ~15 min
- Cost: ~$1.60

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Confirm execution? [y/n/modify]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> Step 5 doesn't need Session deletion, keep compatibility for 2 weeks

Claude Code:
  Updated plan:
  Step 5: Keep Session compatibility
  - express-session を削除しない
  - 双認証サポート（Session + JWT）を追加
  - 2週間後に Session コードをクリーンアップ

  Confirm? [y/n/modify] y
  Starting execution...

[Step 1/5] Create JWT utility module
  → src/auth/jwt.ts を作成中
  → 実行中: npm test -- jwt.test.ts
  ✅ Step 1 complete

/checkpoint "jwt-module-complete"

[Step 2/5] Modify auth middleware
  → src/middleware/auth.ts を修正中
  → 実行中: npm test -- auth.test.ts
  ✅ Step 2 complete

[Step 3/5] Modify login/register routes
  ✅ Step 3 complete

[Step 4/5] Modify protected routes
  → 実行中: npm test
  ❌ 3テスト失敗
  → 根本原因：一部ルートが req.session に依存
  → 修正：ミドルウェアで JWT payload を req.user にマッピング
  → 再実行: npm test ✅

> /plan Migrate entire microservice project from JavaScript to TypeScript

Claude Code が詳細な計画を生成：

## Phase 1: Infrastructure (1-2 hours)
  Step 1: TypeScript と型定義をインストール
  Step 2: tsconfig.json を作成（最初は loose mode）
  Step 3: ビルドスクリプトを設定

## Phase 2: Shared Modules (2-3 hours)
  Step 4: shared/types/ を移行（5ファイル）
  Step 5: shared/utils/ を移行（8ファイル）

## Phase 3: Service Modules (3-4 hours, parallelizable)
  Step 6: user-service/ を移行（12ファイル）
  Step 7: order-service/ を移行（15ファイル）
  Step 8: payment-service/ を移行（10ファイル）

## Phase 4: Strict Mode (1-2 hours)
  Step 9: strict モードを有効化
  Step 10: すべての型エラーを修正
  Step 11: フルテスト検証

Total: 53ファイル修正、8ファイル新規
Estimate: ~200K tokens、~$4.00

> Phase ごとに実行、各 Phase 後に /checkpoint

[Phase 1 complete] /checkpoint "ts-infra"
[Phase 2 complete] /checkpoint "shared-modules"
[Phase 3 complete] /checkpoint "services"
[Phase 4 complete] /checkpoint "strict-mode"

✅ すべてのテスト合格、マイグレーション完了！