| name | worktree-workflow |
| description | Git worktree を使用したホスト環境での並行開発ワークフロー。 |
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 <issue_id> <branch_name>
内部処理:
.worktrees/issue-<id> ディレクトリ作成git worktree add 実行- 依存関係のインストール（
npm ci, cargo build 等）
.env ファイル等のコピー（必要な場合）
Phase 2: 実装作業
作成された worktree ディレクトリ内で作業を行います。
cd .worktrees/issue-123
git add .
git commit -m "feat: ..."
Phase 3: PR作成 & クリーンアップ
開発完了後、PRを作成し、worktree を削除します。
/pr-and-cleanup <issue_id>
内部処理:
- 変更を push
- GitHub PR 作成
git worktree remove でディレクトリ削除git worktree prune でメタデータ削除
Worktree 管理コマンド
| アクション | コマンド | 説明 |
|---|
| 作成 | /create-worktree | 新しい worktree を作成 |
| 一覧 | git worktree list | 現在の worktree 一覧を表示 |
| 削除 | /pr-and-cleanup | 作業完了後に削除 |
| 手動削除 | git worktree remove <path> | 強制的に削除する場合 |
注意事項
- .gitignore 設定:
.worktrees/ を必ず .gitignore に追加してください。
- ディスク容量: 複数の worktree を作成するとディスク容量を消費します（特に
node_modules）。
- ホットリロード: 複数の worktree で同時に dev server を起動する場合、ポート競合に注意してください。
関連スキル
create-worktree: Worktree 作成オートメーションpr-and-cleanup: PR作成とクリーンアップgithub-issue-state-management: 環境状態管理
