Git Worktreeで複数ブランチを同時に作業する方法

リポジトリ（.git）
  ├── /project           ← メイン（main ブランチ）
  ├── /project-feature-a ← worktree（feature/a ブランチ）
  └── /project-hotfix    ← worktree（hotfix/xxx ブランチ）

# 既存ブランチを別ディレクトリに展開
git worktree add <ディレクトリパス> <ブランチ名>
 
# 新しいブランチを作りながら展開（-b オプション）
git worktree add -b <新ブランチ名> <ディレクトリパス>

git worktree list

/project           abc1234 [main]
/project-feature-a def5678 [feature/issue-42]
/project-hotfix    ghi9012 [hotfix/login-bug]

# ディレクトリを削除してから登録解除
git worktree remove <ディレクトリパス>
 
# ディレクトリが既に手動削除済みの場合は prune で掃除
git worktree prune

cd /project-feature-a
git status
git add .
git commit -m "feat: ..."
git push

# 現在 feature/new-ui ブランチで作業中
# → 急ぎのバグ修正依頼が来た
 
# hotfix 用の worktree を作成
git worktree add -b hotfix/login-error ../project-hotfix
 
# hotfix ディレクトリで修正・コミット・プッシュ
cd ../project-hotfix
# ... 修正作業 ...
git commit -m "fix: ログインエラーを修正"
git push origin hotfix/login-error
 
# 元の作業ディレクトリに戻る
cd ../project
# feature/new-ui の作業をそのまま継続
 
# hotfix 完了後に worktree を削除
git worktree

# main ブランチの worktree を追加
git worktree add ../project-main main
 
# ターミナルを2つ開いて比較
# ターミナル1（feature ブランチ）: cd ../project
# ターミナル2（main ブランチ）:    cd ../project-main
 
# 確認が終わったら削除
git worktree remove ../project-main

# implementer エージェント用の worktree を作成
# ブランチ名の "/" を "-" に置換してディレクトリ名にする
git worktree add .claude/worktrees/feature-issue73 feature/issue73
 
# エージェントが独立した worktree で実装
# メインの作業ディレクトリには影響しない
 
# 作業完了後に削除
git worktree remove .claude/worktrees/feature-issue73

# ERROR: ブランチ feature/a は既に使用中
git worktree add ../another-dir feature/a

git worktree list  # 一覧確認
git worktree prune # 孤立した登録を掃除

# worktree を作成した後、必ずセットアップを行う
cd .claude/worktrees/feature-issue73
 
# 依存パッケージのインストール
npm install
 
# 環境変数ファイルをコピー（元の作業ディレクトリからコピーする）
cp ../../.env.local .env.local
 
# 開発サーバーを起動
npm run dev