Claude Code で Laravel→Django 全自動移行をやってみた（2/3）自動化基盤編

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

┌─────────────────────────────────────────────────────┐
│  オーケストレーション層: run-issue.sh             │
│  - Issue 読み込み → ブランチ作成 → Claude 起動    │
│  - リトライ → Push → PR 作成 → マージ → Issue 閉じ │
└──────────────────┬──────────────────────────────────┘
                   ↓
┌─────────────────────────────────────────────────────┐
│  実行層: Claude Code (claude -p)                 │
│  - ソースコード調査 → 設計 → 実装 → テスト        │
│  - コミット（push はしない）                      │
│  - サブエージェント: explorer / architect / reviewer│
└──────────────────┬──────────────────────────────────┘
                   ↓
┌─────────────────────────────────────────────────────┐
│  品質保証層: Hooks + CI + verify-phase.sh        │
│  - Pre-commit: ruff format + check              │
│  - PostToolUse: 編集時の即座リント               │
│  - CI: lint → Django check → pytest             │
│  - Phase 検証: ファイル存在 + 機能チェック        │
└─────────────────────────────────────────────────────┘

1

./scripts/run-issue.sh <issue_number>

1
2
3
4
5
6
7
8

1. GitHub Issue を読み込み（gh issue view）
2. 依存 Issue の完了チェック
3. feature ブランチを作成（main から分岐）
4. Claude Code を起動（claude -p <prompt>）
5. 完了判定（コミット有無 + テスト結果）
6. 失敗時: 最大 3 回リトライ（10 秒クールダウン）
7. 成功時: push → PR 作成 → マージ → Issue 閉じ
8. 実行ログを execution.md に追記

1
2

./scripts/run-issue.sh all    # 全 Issue を順次実行
./scripts/run-issue.sh resume # 中断した Issue から再開

1
2
3
4

# リトライ時のプロンプト（概念）
"前回の実行が失敗しました。
git status, git diff, git log を確認し、
前回の作業状態を把握してから再開してください。"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

Step 1: Issue を読む（gh issue view で全文取得）
Step 2: ソースコード調査（feature-dev:code-explorer サブエージェント）
Step 3: 設計（feature-dev:code-architect サブエージェント、複雑な場合）
Step 4: 実装（Django のベストプラクティスに従う）
Step 5: テスト作成（pytest-django）
Step 6: 品質チェック（ruff format + check + Django check）
Step 7: コードレビュー（feature-dev:code-reviewer サブエージェント）
Step 8: 指摘事項の修正
Step 9: verify-phase.sh の実行
Step 10: execution.md への記録

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(docker compose *)",
      "Bash(uv run *)",
      "Bash(gh issue view *)",
      "Read", "Edit", "Write", "Glob", "Grep"
    ]
  }
}

1
2
3
4
5
6
7
8

#!/bin/bash
# .githooks/pre-commit
STAGED_PY=$(git diff --cached --name-only --diff-filter=d -- '*.py')
[ -z "$STAGED_PY" ] && exit 0

uv run ruff format $STAGED_PY
uv run ruff check --fix $STAGED_PY
git add $STAGED_PY

1
2
3
4

#!/bin/bash
# .claude/hooks/post-edit-lint.sh
# Claude が Python ファイルを編集するたびに ruff check を実行
uv run ruff check "$FILE_PATH"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

#!/bin/bash
# scripts/verify-phase.sh <issue_number>

echo "=== Phase 検証開始 ==="

# 共通チェック
check "git 状態がクリーン" git diff --quiet HEAD
check "ruff format" uv run ruff format --check .
check "ruff check" uv run ruff check .
check "Django check" uv run python manage.py check
check "マイグレーション整合性" uv run python manage.py makemigrations --check --dry-run

# Phase 固有チェック（ファイル存在確認など）
case $ISSUE in
  2) check "masters/models.py が存在" test -f masters/models.py ;;
  5) check "accounts/middleware.py が存在" test -f accounts/middleware.py ;;
  # ...
esac

# テスト実行
check "pytest 全パス" uv run pytest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# .github/workflows/ci.yml
jobs:
  lint:
    steps:
      - run: uv run ruff format --check .
      - run: uv run ruff check .

  django-check:
    needs: lint
    services:
      mysql: { image: mysql:8.0 }
    steps:
      - run: uv run python manage.py check
      - run: uv run python manage.py makemigrations --check --dry-run

  test:
    needs: django-check
    steps:
      - run: uv run pytest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# docker-compose.yml
services:
  db:
    image: mysql:8.0
    volumes:
      - ./docker/mysql/init/001-dump.sql:/docker-entrypoint-initdb.d/001-dump.sql
    # ↑ 既存 DB ダンプを初回起動時に自動リストア

  app:
    build: .
    depends_on:
      db: { condition: service_healthy }
    volumes:
      - .:/app  # ライブリロード用

  nginx:
    image: nginx:alpine
    ports: ["8080:80"]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

### Issue #2: マスタ系モデル定義
- 開始: 2026-03-26 12:18:50
- リトライ 2: 2026-03-26 12:31:22
- 完了: 2026-03-26 12:33:21
- 所要時間: 14分32秒
- 試行回数: 2
- 結果: 成功

#### 作業内容
- inspectdb で全テーブルのモデル雛形を自動生成
- マスタ系 10 モデルを分類・整理
- ForeignKey リレーション設定
- Django Admin に登録
...