100ファイルを一気にリファクタリングする

100ファイルを一気にリファクタリングする

Claude Codeには大規模な変更を並列で実行する/batchスキルと、分離された作業環境を提供するgit worktree機能があります。

/batch スキルによる並列大規模変更

/batchは変更の説明を提供すると、コードベースを調査し、作業を5〜30の独立したユニットに分解し、承認後に各ユニットごとに1つのバックグラウンドエージェントを生成します。各エージェントは分離されたgit worktreeで実行されます。

# 例：フレームワーク移行
/batch src/ 内のSolidコンポーネントをすべてReactに移行

# 例：API形式の統一
/batch すべてのAPIエンドポイントのレスポンス形式を統一フォーマットに変更

# 例：テスト追加
/batch テストのないすべてのモジュールにユニットテストを追加

/batchの流れ：

1. コードベースを調査して作業範囲を特定
2. 独立したユニットに分解してプランを提示
3. ユーザーが承認
4. 各ユニットごとにバックグラウンドエージェントが分離されたgit worktreeで並列実行
5. 各エージェントが実装→テスト→PRを作成

git worktree による並列セッション

--worktree（-w）フラグで分離された作業環境を作成します。

# worktreeを作成してClaude Codeを起動
claude --worktree feature-auth

# 別のworktreeで別のセッション
claude --worktree bugfix-123

# ランダムな名前で自動生成
claude --worktree

Worktreeは<repo>/.claude/worktrees/<name>に作成され、同じリポジトリ履歴を共有しつつ独立したファイルとブランチを持ちます。

/simplify でコード品質チェック

大規模変更後は/simplifyスキルで品質チェックします。3つのレビューエージェント（コード再利用・品質・効率）が並列で分析し、問題を修正します。

# 変更後の品質チェック
/simplify

# 特定の懸念事項に焦点
/simplify メモリ効率に注目して

実践のポイント

• /batchはgitリポジトリ必須。各エージェントがPRを作成するのでレビューしやすい
• worktree終了時、変更がなければ自動クリーンアップ、変更があればプロンプトで選択
• .claude/worktrees/を.gitignoreに追加するのがベストプラクティス