parallel-explore

Create isolated git worktrees to explore and compare implementation approaches.

182|33|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/YougLin-dev/Aha-Loop --skill parallel-explore-youglin-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-explore
Source: https://github.com/YougLin-dev/Aha-Loop/tree/main/.agents/skills/parallel-explore
Command: npx skills add https://github.com/YougLin-dev/Aha-Loop --skill parallel-explore-youglin-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides teams to explore multiple implementation approaches in parallel using git worktrees, reducing bias from a single path and accelerating decision making.

Core Features & Use Cases

  • Isolated parallel worktrees: Create independent workspaces for each approach to test and compare.
  • Guided exploration flow: Step-by-step process from decision point to evaluation and merge.
  • Documentation of results: Produce EXPLORATION_RESULT.md in each worktree and an overall evaluation narrative.
  • Nested exploration & logging: Support nested decisions and keep a trace of exploration decisions in logs.

Quick Start

Start a parallel exploration with a set of approaches and a task description:

  • Command: ./scripts/aha-loop/parallel-explorer.sh explore "task description" --approaches "approach1,approach2"
  • Check progress: ./scripts/aha-loop/parallel-explorer.sh status
  • When ready, evaluate: ./scripts/aha-loop/parallel-explorer.sh evaluate explore-task-12345
  • Merge the winner: ./scripts/aha-loop/parallel-explorer.sh merge explore-task-12345 chosen-approach
  • Cleanup: ./scripts/aha-loop/parallel-explorer.sh cleanup explore-task-12345

Frequently Asked Questions about parallel-explore

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I explore multiple implementation approaches in parallel to avoid biased decisions?

Parallel exploration uses git worktrees to create isolated workspaces for each approach, allowing rapid comparison and reducing bias from a single-path decision. It guides teams from the decision point through evaluation and merge.

When do I need git worktrees for architecture comparison and experimentation?

Git worktrees are needed when several viable architecture paths or library designs exist and rapid comparison is required. They provide independent environments to test conflicting approaches simultaneously without corrupting the main branch.

How do I start a parallel exploration flow for different optimization decisions?

Run the parallel-explorer script with a task description and a list of approaches. Check progress using the status command, evaluate results, merge the chosen approach, and finally cleanup the worktrees.

Does parallel exploration support nested decisions and logging during the workflow?

Yes, the parallel exploration workflow supports nested exploration decisions and maintains a trace of exploration decisions in logs. It also records detailed outcomes in an EXPLORATION_RESULT.md file within each worktree.

What is the best way to evaluate and merge the winner from parallel git worktrees?

Use the evaluate command to compare the EXPLORATION_RESULT.md files from each worktree, then execute the merge command with the chosen approach name to integrate the winning path back into the main project workspace.

What prerequisites do I need to run parallel explorations using git worktrees?

You need the parallel-explorer script and an existing project workspace. The skill operates by creating isolated git worktrees within your repository to test various implementation approaches independently.