vanman2024 Worktree Orchestration Skill
Purpose
Provides scripts, templates, and documentation for managing git worktrees in multi-agent parallel development workflows.
What It Provides
Scripts (scripts/)
- start-verification.sh - Verifies worktree setup before agents begin work
- mid-monitoring.sh - Monitors agent progress and task completion
- end-verification.sh - Validates PR readiness and generates push commands
- setup-worktree-symlinks.sh - Creates symlinks for task visibility across worktrees
Templates (templates/)
- start-report.template.md - Pre-work verification report format
- mid-report.template.md - Progress monitoring report format
- end-report.template.md - PR readiness report format
- supervisor-report.template.md - General supervisor report format
Documentation (docs/)
- Worktree management patterns
- Agent coordination protocols
- Compliance rules per agent type
Memory (memory/)
- Agent expectations and responsibilities
- Worktree usage rules
- Coordination protocols
When to Use
Use this skill when:
- Setting up parallel agent development environments
- Monitoring multi-agent progress
- Validating work before PR creation
- Managing git worktree lifecycle
Integration
Commands that use this skill:
/supervisor:init- Uses worktree creation patterns/supervisor:start- Uses start-verification.sh/supervisor:mid- Uses mid-monitoring.sh/supervisor:end- Uses end-verification.sh
Key Concepts
Worktree Isolation
Each agent gets:
- Dedicated branch:
agent-{name}-{spec-number} - Isolated worktree:
../{project}-{spec-number}-{agent-name} - Symlinked task visibility to main repo
Progress Tracking
Monitor via:
- Task completion in layered-tasks.md
- Git commit history per worktree
- Test results (optional with --test flag)
PR Coordination
Generate:
- Push commands per agent branch
- PR creation commands with proper metadata
- Cleanup commands for post-merge worktree removal