iteratelisted

# /iterate — Diverge, Compare, Converge Spin up N parallel agents on isolated git worktrees, each exploring a different direction for the same problem. Review all variants, pick the best, merge it back. ## When to Use - User wants to explore multiple approaches to a problem - Design/UI work where visual comparison matters - Refactoring where there are multiple valid strategies - Any task where "try a few things and pick the best" is the right move ## Prerequisites - Must be inside a git repository with a clean working tree (or stashable changes) - The repo should have committed state to branch from ## Usage ``` /iterate <task description> /iterate 3 <task description> # explicit count (default: 3) /iterate 2 redesign the settings page using shadcn ``` ## How It Works ### Phase 1: Parse Arguments Parse `$ARGUMENTS` to extract: - **N** (number of variants): First token if it's a number 1-5, otherwise default to **3** - **Task**: Everything after the count (or all of $ARGUMENTS if no count) If no arguments provided, ask the user: 1. What task/problem should the agents explore? 2. How many variants? (default 3) ### Phase 2: Generate Divergent Angles Before spawning agents, generate N distinct approaches. These should be meaningfully different, not just cosmetic variations. **Example for "redesign the settings page":** 1. Minimal — strip to essentials, single scrollable page, maximum whitespace 2. Tabbed — group settings into logical tabs with a sidebar nav 3.