Worktrees for Parallel Cycles

Git worktrees enable working on multiple TDD cycles simultaneously without switching branches.

Quick Start

1
2
3
4
5
6
7
8
9
10
11

# Start a cycle (creates branch + issue)
just cycle-start 1 1 A happy-path

# Create worktree for another cycle
just cycle-worktree 1 2 B validation

# List active worktrees
just worktrees

# Remove worktree when done
just cycle-worktree-remove 1 2

Directory Layout

1
2
3
4
5

projects/
├── SEA™/                    # Main repo (usually on dev)
├── SEA-p1-c1/              # Worktree for Phase 1, Cycle 1
├── SEA-p1-c2/              # Worktree for Phase 1, Cycle 2
└── SEA-p1-c3/              # Worktree for Phase 1, Cycle 3

Parallel Limit

Maximum 3 cycles in parallel to maintain:

Wave Execution

Waves define execution order based on agent id length:

Wave Agent IDs Execute
1 A, B, C Parallel (up to 3)
2 AA, BB After Wave 1 complete
3 AAA, BBB After Wave 2 complete

AI Agent Usage

When creating plans, AI agents should:

  1. Parse phases into cycles
  2. Assign waves based on dependencies
  3. Generate branch names following the convention
  4. Specify explicit file modification lists