worktree-create

Worktree Create

ブランチのリストから、任意の数の分離された Git worktree を作成します。それぞれ適切なベースから作成し、Git で無視される設定ファイルを用意し、依存関係をインストールしてヘルスチェックを実行します。worktree ごとにセットアップ用サブエージェントを 1 つ起動して並列実行することで、これを実現します。各 worktree で行う作業はアプリに依存せず、ハードコードではなくリポジトリから検出します。

入力

$ARGUMENTS は作成するブランチのリストです。

• 指定なし → 作成するブランチを確認する（または進行中のチケットから導き出すことを提案する）。推測しないでください。
• 1 つ → 単一の worktree をその場でセットアップする（1 つだけのファンアウトは不要です）。
• 2 つ以上 → ブランチごとにサブエージェントを 1 つ起動し、並列に処理します。

ファンアウト前にプロジェクトのセットアップを一度だけ検出する

references/worktree-setup.md を読みます。新しい worktree に必要なものすべてと、それぞれの検出方法をまとめた一般的なチェックリストです。このリポジトリから（推測せずに）次の項目を一度だけ確認します。

• インストールコマンド（モノレポの場合はパッケージごとに 1 つ）
• コピーする Git で無視される環境変数／設定ファイル（またはリポジトリの .worktreeinclude）
• 検証／ヘルスチェックコマンド（アプリにヘルスエンドポイントがあればそれを使用し、なければビルド／テストのスモークチェックを実行します。CI で使われている方法を優先します）
• ヘルスチェックでサービスを起動する場合に限り、ベースポート

worktree のルートとして worktrees/<branch>（Git で無視されます）を選びます。サービスを起動する場合は、並列実行されるサーバーが競合しないよう、worktree ごとに異なるポート（base + index）を割り当てます。

ブランチごとにセットアップ用サブエージェントを 1 つ並列に起動する

Task ツールを使って、すべてのサブエージェントを同時に起動します。各サブエージェントには同じプロンプトを渡し、BRANCH と PORT だけを置き換えます。

Set up a git worktree for branch: BRANCH   (assigned port: PORT, only relevant if you start a service)

Follow the checklist in .claude/skills/worktree-create/references/worktree-setup.md. Concretely:
1. Create the worktree off the base branch:  git worktree add worktrees/BRANCH -b BRANCH
2. Copy the gitignored config/secrets the project needs into worktrees/BRANCH
   (the env/config files detected for this repo; verify each with `git check-ignore` before copying).
3. Install dependencies with the project's detected package manager (every package, for a monorepo).
4. Run any generate/build step the app needs to boot (skip if none).
5. Verify: run the detected health check (start + hit the health endpoint on PORT if there is one,
   else a build/typecheck/test smoke). Then stop any server you started.

Report exactly: worktree path · branch · deps installed (yes/no) · health check (PASS/FAIL) · any errors.

検出したコマンド（インストール、環境ファイルの一覧、ヘルスチェック）をテンプレートに入力します。ブランチが 1 つの場合は、サブエージェントを起動せずに手順を直接実行します。

結果をまとめて報告する

各サブエージェントの報告を集め、worktree ごとの概要（パス · ブランチ · 依存関係 · ヘルスチェック · ポート）、全体の N worktree(s) ready 行、次のステップ（各 worktree を開く／その中で PIV ループを開始する）、およびクリーンアップの注意事項を出力します。ブランチのマージ後は次を実行してください。

git worktree remove worktrees/<branch>

いずれかの worktree でヘルスチェックに失敗した場合は、そのことを明確に伝え、準備完了として報告しないでください。

リソース

• references/worktree-setup.md — 新しい worktree に必要なものすべてと、プロジェクトごとの検出方法をまとめた、アプリに依存しない一般的なチェックリストです。セットアップを検出する前に読んでください。