execute-plan-parallel

Files (1)

• SKILL.md

SKILL.md (first lines)

# Superpowers Execute Plan (Parallel Mode)

## Overview
This workflow executes an approved plan by identifying independent steps and running them in parallel using isolated subagents.

## When to use parallel mode
- Plan has 2+ steps that don't depend on each other
- Steps operate on different files or independent modules
- You want faster execution (parallel > sequential)

## When NOT to use parallel mode
- Steps have dependencies (Step 2 needs Step 1's output)
- All steps modify the same file
- Plan has < 2 steps
- You want simpler debugging (sequential is easier to debug)

**If unsure, use `/superpowers:execute-plan` (sequential) instead.**

---

## Preconditions (do not skip)

1. The user must have replied **APPROVED** to a written plan
2. The approved plan must exist at: `artifacts/superpowers/plan.md`

If `artifacts/superpowers/plan.md` does not exist:
- Stop immediately
- Tell the user to run `/superpowers:write-plan` first
- Do not continue

---

## Load and analyze the plan

1. Read `artifacts/superpowers/plan.md`
2. Parse all plan steps
3. Identify dependencies between steps:
   - Does Step 2 modify files created/changed by Step 1?
   - Does Step 2 need Step 1's verification to pass first?
   - Do they modify the same files?
4. Group steps into execution batches:
   - **Batch 1**: All independent steps (no dependencies)
   - **Batch 2**: Steps that depend on Batch 1 completing
   - **Batch 3**: Steps that depend on Batch 2 completing
   - etc.

---

## Execution strategy

### For each batch:

1. **Spawn subagents in parallel** for all steps in the batch:

```bash
# Example: Batch 1 has 3 independent steps. Use the spawn_subagent.py script located under the plugin's skills/workflow/scripts/ directory (e.g. ~/.gemini/antigravity-cli/plugins/superpowers/skills/workflow/scripts/spawn_subagent.py) or .agent/skills/workflow/scripts/:
python <path_to_spawn_subagent>/spawn_subagent.py \
  --skill tdd \
  --task "Step 1: Add retry logic to sync.py with exponential backoff" &

python <path_to_spawn_subagent>/spawn_subagent.py \
  --skill rest-automation \
  --task "Step 2: Add pagination handling to fetch_items()" &

python <path_to_spawn_subagent>/spawn_subagent.py \
  --skill python-automation \
  --task "Step 3: Update CLI args to support --max-retries flag" &

# Wait for all to complete
wait
```

2. **Collect results** from each subagent:
   - Check log files in `artifacts/superpowers/subagents/`
   - Extract final results from each
   - Check success/failure status

3. **Verify batch completion**:
   - Run verification commands for all steps in the batch
   - If ANY step fails:
     - Stop execution
     - Switch to `/superpowers:debug` for the failed step
     - Do NOT continue to next batch

4. **Append to execution log**:
   - Write batch summary to `artifacts/superpowers/execution.md`:
     ```markdown
     ## Batch N (Parallel Execution)
     - Step X: [SUCCESS/FAILED] - Files: [...] - Duration: Xs
     - Step Y: [SUCCESS/FAILED] - Files: [...] - Duration: Ys

     Verification:
     - Step X: [command] -> [result]
     - Step Y: [command] -> [result]
     ```

5. **Move to next batch** (if all steps passed)

---

## Skill selection for subagents

Choose the appropriate skill for each step:

| Step Type | Skill to Use |
|-----------|-------------|
| Add tests, TDD cycle | `tdd` |
| Fix bugs, investigate failures | `debug` |
| Code review, quality check | `review` |
| REST API work | `rest-automation` |
| Python tooling/scripts | `python-automation` |
| General implementation | `tdd` (default) |

---

## Consolidation phase

After all batches complete:

From aryansx/antigravity-superpowers-plugin, MIT.

More from aryansx/antigravity-superpowers-plugin