git-worktree-manager

Git Worktree マネージャー

メインの作業ディレクトリをクリーンな状態に保ちながら、複数のブランチで並行開発できるように Git worktree を管理します。

推奨ディレクトリ構成

project/
├── main-repo/          # Main working directory
└── worktrees/          # All worktrees here
    ├── feature/name/
    ├── bugfix/name/
    └── experiment/name/

主なコマンド

Worktree の作成

# From existing branch
git worktree add ../worktrees/feature-name feature-branch

# Create new branch
git worktree add -b feature/new ../worktrees/new-feature

# Detached HEAD (specific commit)
git worktree add ../worktrees/temp HEAD~5

Worktree の一覧表示

git worktree list
git worktree list --porcelain  # Machine-readable

Worktree の削除

git worktree remove ../worktrees/name        # Safe (clean only)
git worktree remove --force ../worktrees/name  # Force removal
git worktree prune                           # Clean administrative data

ロック／ロック解除

git worktree lock ../worktrees/name    # Prevent operations
git worktree unlock ../worktrees/name

ワークフローのパターン

機能開発

git worktree add -b feature/new ../worktrees/feature/new
cd ../worktrees/feature/new
# ... develop ...
cargo test  # Test in isolation
git push
cd /path/to/main && git merge feature/new
git worktree remove ../worktrees/feature/new

並行テスト

for branch in feature/a feature/b; do
  git worktree add ../worktrees/$branch $branch
  cd ../worktrees/$branch && cargo test &
done
wait

コードレビュー

git worktree add ../worktrees/review/pr-123 origin/pr-123
cd ../worktrees/review/pr-123
cargo test
git worktree remove ../worktrees/review/pr-123

孤立した Worktree の検索

git worktree list | while read path commit branch; do
  if ! git show-ref --verify --quiet "refs/heads/${branch#*/}"; then
    echo "Orphaned: $path"
  fi
done

ベストプラクティス

推奨事項

• ../worktrees/ ディレクトリに整理します
• ブランチ名に基づいた分かりやすい名前を使用します
• マージ後にクリーンアップします
• main にマージする前にテストします
• 孤立したデータを削除するため、定期的に prune します

禁止事項

• 無作為な場所に作成しないでください
• 未コミットの変更を残さないでください
• 管理データの prune を忘れないでください
• 競合するブランチを作成しないでください
• worktree を使うワークフローと使わないワークフローを混在させないでください