git-worktree-managerlisted
Install: claude install-skill DROOdotFOO/agent-skills
# git-worktree-manager
Parallel development using git worktrees with deterministic port allocation.
Designed for multi-agent workflows where multiple branches run services
concurrently without port collisions.
## What You Get
- Worktree lifecycle management (create, list, cleanup)
- Deterministic port allocation with collision detection
- Docker Compose patterns for per-worktree services
- Decision matrix for when worktrees add value
## Workflow
1. **Decide** -- Check the decision matrix below. Worktrees add overhead;
use them only when parallelism is required.
2. **Create** -- `git worktree add ../project-feature feature-branch`
3. **Allocate ports** -- Use deterministic formula from port-allocation.md
4. **Run sessions** -- Each worktree gets isolated services on unique ports
5. **Cleanup** -- `git worktree remove ../project-feature` and release ports
## Decision matrix
| Situation | Use worktree? | Why |
| ------------------------------------------ | ------------- | ---------------------------------------- |
| Quick fix while feature branch is running | Yes | Keep feature services up, fix on main |
| Multiple agents working different features | Yes | Each agent gets isolated environment |
| Long-running test suite on one branch | Yes | Continue development without waiting |
| Simple feature branch, no running services | No | git checkout