parallel-worktrees

並行ワークツリー

待ち時間をゼロに。あるセッションでテストを実行している間に、別の作業を進めましょう。

トリガー

テストや長時間のビルドを待っているとき、アプローチを検討しているとき、またはレビューと開発を同時に行う必要があるときに使用します。

クイックスタート

Claude Code：

claude --worktree    # or claude -w (auto-creates isolated worktree)

Cursor ／その他のエディター：

git worktree add ../project-feat feature-branch
# Open the new worktree folder in a second editor window

どちらの方法でも、メインセッションと変更が干渉しない、独立した作業コピーが作成されます。

Claude Code の追加機能

以下の機能は Claude Code 専用です（Cursor を使用している場合はスキップしてください）。

• claude -w はワークツリーを自動的に作成し、クリーンアップします
• サブエージェントは、エージェントのフロントマターで isolation: worktree をサポートします
• Ctrl+F はバックグラウンドエージェントをすべて終了します（2 回押して確認）
• Ctrl+B はタスクをバックグラウンドに送ります

ワークフロー

1. 現在のワークツリーを表示します：git worktree list
2. 並行タスク用のワークツリーを作成します。
3. ワークツリー内で新しいエディターまたはターミナルのセッションを開きます。
4. 完了したら、ワークツリーをクリーンアップします。

コマンド

git worktree list

git worktree add ../project-feat feature-branch
git worktree add ../project-fix bugfix-branch
git worktree add ../project-exp -b experiment

git worktree remove ../project-feat
git worktree prune

使用パターン

Terminal 1: ~/project          → Main work
Terminal 2: ~/project-feat     → Feature development
Terminal 3: ~/project-fix      → Bug fixes

各ワークツリーでは、独立して AI セッションを実行します。

並列化するタイミング

シナリオ	アクション
テストの実行中（2 分以上）	ワークツリーで新機能の開発を開始する
長時間のビルド	並行して問題をデバッグする
アプローチの検討	2～3 個を同時に比較する
レビューと新規作業	一方でレビュー、もう一方で開発する
CI の待機中	ワークツリーで次のタスクを開始する

ガードレール

• 各ワークツリーは完全な作業コピーであり、変更は分離されています。
• ワークツリーを削除する前に、変更がコミットされていることを確認します：git -C ../project-feat status
• 作業が終わったら、ワークツリーをクリーンアップするのを忘れないでください（git worktree prune）。
• 複数のワークツリーで同じファイルを同時に編集しないでください。

出力

• 現在のワークツリー一覧
• 作成したワークツリーのパスとブランチ
• 新しいセッションを開く手順