Aha-Loop: Skill for Claude Code

Parallel Exploration Skill

Guide the process of exploring multiple implementation approaches simultaneously using git worktrees.

---

The Job

1. Identify when parallel exploration would be valuable
2. Define distinct approaches to explore
3. Create isolated worktrees for each approach
4. Execute exploration in parallel
5. Evaluate and compare results
6. Merge the best solution

---

When to Use Parallel Exploration

Good Candidates

• Architecture decisions - Different patterns (e.g., microservices vs monolith)
• Library selection - Comparing similar libraries hands-on
• Algorithm choices - Different approaches to the same problem
• API design - Different interface designs
• Performance optimization - Multiple optimization strategies

Not Worth Parallelizing

• Simple, clear-cut decisions
• Tasks with obvious single approach
• Very small changes
• Changes that don't warrant the overhead

---

Exploration Process

Step 1: Identify the Decision Point

When you encounter a significant decision:

## Decision Point Identified

**Question:** [What needs to be decided]
**Context:** [Why this matters]
**Approaches to Explore:**
1. [Approach A] - [Brief description]
2. [Approach B] - [Brief description]
3. [Approach C] - [Brief description]

**Exploration Value:** [Why parallel exploration helps here]

Step 2: Start Exploration

Use the parallel explorer script:

./scripts/aha-loop/parallel-explorer.sh explore "task description" --approaches "approach1,approach2,approach3"

Or let AI suggest approaches:

./scripts/aha-loop/parallel-explorer.sh explore "task description"
# AI will suggest approaches automatically

Step 3: Work in Each Worktree

In each worktree, the AI should:

1. Implement fully - Not just a stub, but working code
2. Write tests - Validate the approach works
3. Document findings - Create EXPLORATION_RESULT.md

Step 4: Create Exploration Result

Each worktree must have EXPLORATION_RESULT.md: