Git Worktrees の使用

概要

Git worktrees は同じリポジトリを共有する分離されたワークスペースを作成し、ブランチの切り替えなしに複数のブランチで同時に作業できます。

コア原則: システマティックなディレクトリ選択 + 安全性検証 = 信頼できる分離

開始時にアナウンス: 「using-git-worktrees スキルを使用して分離されたワークスペースをセットアップします。」

ディレクトリ選択プロセス

この優先順位に従ってください:

1. 既存ディレクトリの確認

# 優先順位順に確認
ls -d .worktrees 2>/dev/null     # 推奨 (隠しディレクトリ)
ls -d worktrees 2>/dev/null      # 代替案

見つかった場合: そのディレクトリを使用してください。両方存在する場合は .worktrees が優先されます。

2. CLAUDE.md を確認

grep -i "worktree.*director" CLAUDE.md 2>/dev/null

設定が指定されている場合: 確認なしにそれを使用してください。

3. ユーザーに質問

ディレクトリが存在せず、CLAUDE.md に設定がない場合:

worktree ディレクトリが見つかりません。worktrees をどこに作成しますか?

1. .worktrees/ (プロジェクトローカル、隠しディレクトリ)
2. ~/.config/superpowers/worktrees/<project-name>/ (グローバル位置)

どちらをお望みですか?

安全性検証

プロジェクトローカルディレクトリ用 (.worktrees または worktrees)

worktree 作成前にディレクトリが無視されていることを検証してください:

# ディレクトリが無視されているか確認 (ローカル、グローバル、システム gitignore を考慮)
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null

無視されていない場合:

Jesse の「壊れたものはすぐに修正する」ルールに従い:

1. 適切な行を .gitignore に追加
2. 変更をコミット
3. worktree 作成に進む

重要な理由: worktree の内容をリポジトリに誤ってコミットするのを防ぎます。

グローバルディレクトリ用 (~/.config/superpowers/worktrees)

.gitignore 検証は不要です - プロジェクトの外にあるため。

作成ステップ

1. プロジェクト名を検出

project=$(basename "$(git rev-parse --show-toplevel)")

2. Worktree を作成

# フルパスを決定
case $LOCATION in
  .worktrees|worktrees)
    path="$LOCATION/$BRANCH_NAME"
    ;;
  ~/.config/superpowers/worktrees/*)
    path="~/.config/superpowers/worktrees/$project/$BRANCH_NAME"
    ;;
esac

# 新しいブランチで worktree を作成
git worktree add "$path" -b "$BRANCH_NAME"
cd "$path"

3. プロジェクトセットアップを実行

適切なセットアップを自動検出して実行:

# Node.js
if [ -f package.json ]; then npm install; fi

# Rust
if [ -f Cargo.toml ]; then cargo build; fi

# Python
if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
if [ -f pyproject.toml ]; then poetry install; fi

# Go
if [ -f go.mod ]; then go mod download; fi

4. クリーンなベースラインを検証

テストを実行して worktree がクリーンな状態で開始されることを確認:

# 例 - プロジェクトに適したコマンドを使用
npm test
cargo test
pytest
go test ./...

テストが失敗した場合: 失敗を報告し、進行するか調査するかについてユーザーに確認してください。

テストが成功した場合: 準備完了を報告してください。

5. 場所を報告

Worktree ready at <full-path>
Tests passing (<N> tests, 0 failures)
Ready to implement <feature-name>

クイックリファレンス

状況	アクション
.worktrees/ が存在	これを使用 (無視を検証)
worktrees/ が存在	これを使用 (無視を検証)
両方存在	.worktrees/ を使用
どちらも存在しない	CLAUDE.md を確認 → ユーザーに質問
ディレクトリが無視されていない	.gitignore に追加 + コミット
ベースライン中にテストが失敗	失敗を報告 + 確認
package.json/Cargo.toml なし	依存関係インストールをスキップ

よくある間違い

無視の検証をスキップ

• 問題: worktree の内容がトラッキングされ、git status を汚染
• 対策: プロジェクトローカル worktree 作成前に常に git check-ignore を使用

ディレクトリの場所を仮定

• 問題: 一貫性の欠如、プロジェクト規則の違反
• 対策: 優先順位に従う: 既存 > CLAUDE.md > 質問

テスト失敗で進行

• 問題: 新しいバグと既存の問題を区別できない
• 対策: 失敗を報告し、明示的な許可を得る

セットアップコマンドをハードコード

• 問題: 異なるツールを使用するプロジェクトで機能しない
• 対策: プロジェクトファイル (package.json など) から自動検出

ワークフロー例

You: using-git-worktrees スキルを使用して分離されたワークスペースをセットアップします。

[.worktrees/ を確認 - 存在]
[無視を検証 - git check-ignore が .worktrees/ が無視されていることを確認]
[worktree を作成: git worktree add .worktrees/auth -b feature/auth]
[npm install を実行]
[npm test を実行 - 47 件通過]

Worktree ready at /Users/jesse/myproject/.worktrees/auth
Tests passing (47 tests, 0 failures)
Ready to implement auth feature

危険な兆候

決して:

• 無視されていることを検証せずに worktree を作成しない (プロジェクトローカル)
• ベースラインテスト検証をスキップしない
• 確認なしにテスト失敗で進行しない
• ディレクトリの場所が曖昧な場合に仮定しない
• CLAUDE.md チェックをスキップしない

常に:

• ディレクトリ優先順位に従う: 既存 > CLAUDE.md > 質問
• プロジェクトローカル用にディレクトリが無視されていることを検証
• プロジェクトセットアップを自動検出して実行
• クリーンなテストベースラインを検証

統合

呼び出し元:

• brainstorming (フェーズ 4) - デザインが承認され実装が進む場合に必須
• 分離されたワークスペースが必要なスキル

ペアで使用:

• finishing-a-development-branch - 作業完了後のクリーンアップに必須
• executing-plans または subagent-driven-development - このワークスペースで作業実施

使用時期

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• このスキルは、上記で説明されたスコープと明らかに一致するタスクの場合のみ使用してください。
• 環境固有の検証、テスト、またはエキスパートレビューの代替として出力を扱わないでください。
• 必要な入力、許可、安全性の境界、または成功基準が不足している場合は、停止して説明を求めてください。