Worktree Workflow

.agents/worktree/<name> に置く専用 worktree の 手順 を定める。「いつ worktree が必須か」「例外は何か」という 方針は rules/git-workflow.md が持つので、ここでは繰り返さない。 このスキルは Claude Code と Codex の両方で使う。Claude Code では --worktree や isolation 起動時に kit の WorktreeCreate hook が作成を代行するので、その場合は「作成後の手順」から入る。終了時の削除も WorktreeRemove hook が代行するが、未コミット変更・lock・init 済み submodule を含む worktree、 ブランチを切らずに commit した (どのブランチからも到達できない) worktree、キャッシュ以外の ignore 対象 (.env 等) がある worktree は残すので Phase 6 で片付ける。

When to Use

• Issue 解決・機能開発・複数ファイル実装に着手するとき (Plan 承認直後、最初の Edit の前)
• 共有 checkout で編集しようとして hook に「worktree から開始してください」と止められたとき
• 並列実装で worker ごとに作業場所を割り当てるとき
• PR が merge され、worktree を片付けるとき
• 「worktree 切って」「ワークツリー作って」「worktree 一覧」「ワークツリー掃除して」と言われたとき

Layout and Naming