working-in-parallel

並行作業

同じディレクトリで別のエージェントが作業している場合は、git worktree を使って並行作業します。

Git worktree を使うと、複数のブランチを別々のディレクトリにチェックアウトできます。各 worktree はそれぞれ独立したファイルを持ちながら、Git の履歴とリモート接続を共有します。ある worktree での変更が他の worktree に影響しないため、エージェント同士が干渉することなく並行作業できます。

詳細はこちら：Git worktree のドキュメント

重要：Worktree の配置場所

すべての worktree は、リポジトリのルートにある .letta/worktrees/ の下に作成する必要があります。 これにより、worktree を整理し、Git の追跡対象から除外して、ユーザーのプロジェクトディレクトリの外に置けます。

最初の worktree を作成する前に、.letta/worktrees がリポジトリの .gitignore に含まれていることを確認してください。

# Add to .gitignore if not already present
grep -q '.letta/worktrees' .gitignore 2>/dev/null || echo '.letta/worktrees' >> .gitignore

重要：最初にプロジェクトのセットアップを確認する

新しい worktree でコマンドを実行する前に、必ずプロジェクトのセットアップ手順を確認してください。

1. README を読む - 通常、インストールやビルドのコマンドが記載されています
2. claude.md または AGENT.md を確認する - エージェント向けのガイダンスがある場合
3. project のメモリブロックを確認する - プロジェクトについて把握した設定や好みが記載されています

npm、bun、pnpm のどれを使うかを決めつけないでください。まずプロジェクトを確認してください！

クイックスタート

# Ensure .letta/worktrees is gitignored
grep -q '.letta/worktrees' .gitignore 2>/dev/null || echo '.letta/worktrees' >> .gitignore

# Create worktree with new branch (from repo root)
git worktree add -b fix/my-feature .letta/worktrees/my-feature main

# Work in the worktree
cd .letta/worktrees/my-feature

# CHECK PROJECT SETUP FIRST - then install dependencies
# Read README.md or check project memory block for correct command
bun install  # Example - verify this is correct for YOUR project!

# Make changes, commit, push, PR
git add <files>
git commit -m "fix: description"
git push -u origin fix/my-feature
gh pr create --title "Fix: description" --body "## Summary..."

# Clean up when done (from repo root)
git worktree remove .letta/worktrees/my-feature

主なコマンド

git worktree add -b <branch> .letta/worktrees/<name> main  # Create with new branch
git worktree add .letta/worktrees/<name> <existing-branch>  # Use existing branch
git worktree list                                            # Show all worktrees
git worktree remove .letta/worktrees/<name>                  # Remove worktree

使用する場面

• 別のエージェントが現在のディレクトリで作業している
• あるセッションで時間のかかるタスクを進めながら、別のセッションで簡単な修正が必要になった
• エージェントが別の機能に取り組んでいる間、ユーザーが開発を続けたい

Worktree でのコミット前フック

Worktree は .git を共有しますが、プロジェクトのセットアップによってはコミット前フックの初期化が必要な場合があります。worktree の作成と依存関係のインストール後、コミットする前にフックが有効になっていることを確認してください。必要に応じて、プロジェクトのドキュメントを確認するか、プロジェクトのフック設定コマンドを実行してください。

ヒント

• 必ず .letta/worktrees/ を使う - このディレクトリの外に worktree を作成しないでください
• インストール前にプロジェクトのセットアップドキュメントを確認する - README、claude.md、project のメモリブロック
• worktree にはわかりやすい名前を付ける：.letta/worktrees/feature-auth、.letta/worktrees/bugfix-123
• プロジェクトのパッケージマネージャーを確認してから、依存関係をインストールする
• worktree を削除する前に変更をプッシュする

代替案：リポジトリのクローン

メンタルモデルをシンプルにするため、リポジトリを複数回クローンする（gh repo clone owner/repo project-01）方法を好むユーザーもいます。ディスク容量をより多く使いますが、完全に独立した環境を利用できます。ユーザーが worktree に戸惑っている様子を示した場合や、クローンを明示的に希望した場合は、代わりにこの方法を使ってください。