Worktree Workflow

Git Worktree Workflow

Git worktree を使用して、ホスト環境で複数のブランチを並行して安全に開発するためのワークフロー。

概要

git worktree を使用すると、1つのリポジトリで複数のブランチを同時にチェックアウトできます。 これにより、ブランチ切り替え（git checkout）に伴う再ビルドやコンテキストスイッチのコストを回避できます。

メリット

• 並行作業: 複数のIssueを同時に進行可能
• 高速化: ブランチ切り替え時の node_modules やビルドアーティファクトの再生成が不要
• 安全性: 独立したディレクトリでの作業により、未コミットの変更が混ざらない

ディレクトリ構造

project-root/
├── .git/
├── .worktrees/            # worktree 用ディレクトリ（.gitignoreに追加）
│   ├── issue-123/         # Issue #123 用 worktree
│   └── issue-124/         # Issue #124 用 worktree
├── src/
└── package.json

ワークフロー詳細

Phase 1: Worktree 作成

# create-worktree skill を使用
/create-worktree <issue_id> <branch_name>

内部処理:

1. .worktrees/issue-<id> ディレクトリ作成
2. git worktree add 実行
3. 依存関係のインストール（npm ci, cargo build 等）
4. .env ファイル等のコピー（必要な場合）

Phase 2: 実装作業

作成された worktree ディレクトリ内で作業を行います。

cd .worktrees/issue-123
# 実装、テスト、コミット
git add .
git commit -m "feat: ..."

Phase 3: PR作成 & クリーンアップ

開発完了後、PRを作成し、worktree を削除します。

# pr-and-cleanup skill を使用
/pr-and-cleanup <issue_id>

内部処理:

1. 変更を push
2. GitHub PR 作成
3. git worktree remove でディレクトリ削除
4. git worktree prune でメタデータ削除

Worktree 管理コマンド

注意事項

1. .gitignore 設定: .worktrees/ を必ず .gitignore に追加してください。
2. ディスク容量: 複数の worktree を作成するとディスク容量を消費します（特に node_modules）。
3. ホットリロード: 複数の worktree で同時に dev server を起動する場合、ポート競合に注意してください。

関連スキル

• create-worktree: Worktree 作成オートメーション
• pr-and-cleanup: PR作成とクリーンアップ
• github-issue-state-management: 環境状態管理