worktree-management

name	worktree-management
description	Define when and how isolated git worktrees are used for coder agents. Covers worktree creation, allocation, and cleanup.

Worktree Management

Purpose

Define when and how isolated worktrees are used for coder agents.

Use Worktrees When

• multiple coder agents are active
• branch isolation materially reduces interference
• disk and memory overhead are acceptable

Avoid Worktrees When

• the task is small
• a single coder agent is sufficient
• machine resources are constrained

Cleanup Rules

Before deleting a worktree:

• confirm branch state
• confirm uncommitted changes status
• confirm issue and PR state are recorded

Never silently remove a dirty worktree.

Post-Merge Cleanup

After a PR is merged, follow the full Post-Merge Reset sequence defined in agents/commander.md.

Do not consider worktree cleanup complete until the reset sequence finishes.