+---------------------------------------------------------------------+
|                    PARALLEL-DEV WORKFLOW                             |
+---------------------------------------------------------------------+
|  PHASE 1: PLANNING                                                   |
|  +-- /parallel-dev:plan <name>                                       |
|     +-- Vision & Goals questions                                     |
|     +-- Features & Scope questions                                   |
|     +-- Technical Decisions questions                                |
|     +-- Generates: plans/{name}.md                                   |
+---------------------------------------------------------------------+
|  PHASE 2: APPROVAL                                                   |
|  +-- /parallel-dev:plan-show <name>  (review)                        |
|  +-- /parallel-dev:plan-edit <name>  (adjust if needed)              |
|  +-- /parallel-dev:plan-edit <name> --approve                        |
+---------------------------------------------------------------------+
|  PHASE 3: DECOMPOSITION                                              |
|  +-- /parallel-dev:decompose <name>                                  |
|     +-- Breaks into phases (Foundation, Core, Integration, Test)     |
|     +-- Creates tasks with dependencies                              |
|     +-- Identifies parallelization opportunities                     |
|     +-- Generates: plans/{name}-tasks.yaml                           |
+---------------------------------------------------------------------+
|  PHASE 4: EXECUTION                                                  |
|  +-- /parallel-dev:start <name>                                      |
|     +-- Creates worktree at {worktreeBase}/{project}/{name}          |
|     +-- Creates feature branch: feature/{name}                       |
|     +-- Spawns parallel agents (up to maxParallelAgents)             |
|     |   +-- Implementer agents (database, api, frontend)             |
|     |   +-- Tester agents                                            |
|     |   +-- Documenter agents                                        |
|     +-- Tracks progress in executions/{name}/state.yaml              |
|     +-- Continues until all tasks complete                           |
|                                                                      |
|  During execution:                                                   |
|  +-- /parallel-dev:status         (monitor progress)                 |
|  +-- /parallel-dev:pause <name>   (graceful pause)                   |
|  +-- /parallel-dev:resume <name>  (continue work)                    |
+---------------------------------------------------------------------+
|  PHASE 5: VALIDATION                                                 |
|  +-- /parallel-dev:validate <name>                                   |
|     +-- Static Analysis (lint, typecheck, format)                    |
|     +-- Testing (unit tests, integration tests, coverage)            |
|     +-- Build Verification (production build)                        |
|     +-- Acceptance Criteria (verify each criterion)                  |
+---------------------------------------------------------------------+
|  PHASE 6: MERGE                                                      |
|  +-- /parallel-dev:conflicts <name>  (preview conflicts)             |
|  +-- /parallel-dev:merge <name>                                      |
|     +-- Merges feature branch to main                                |
|     +-- Runs post-merge validation                                   |
|     +-- Pushes to remote                                             |
|     +-- Removes worktree                                             |
|     +-- Deletes feature branch                                       |
|     +-- Archives execution                                           |
+---------------------------------------------------------------------+

{
  "worktreeBase": "~/tmp/worktrees",
  "registryPath": ".claude/parallel-dev/registry.json",
  "plansPath": ".claude/parallel-dev/plans",
  "executionsPath": ".claude/parallel-dev/executions",
  "maxParallelAgents": 5,
  "staleThresholdMinutes": 30,
  "autoCleanupWorktrees": true,
  "portPool": { "start": 8100, "end": 8199 },
  "portsPerWorktree": 2,
  "defaultValidation": ["lint", "typecheck", "test", "build"],
  "terminal": "tmux",
  "agentModel": "sonnet",
  "planningModel": "opus"
}

# User wants to build authentication
User: "I want to build user authentication for my Express app"

# Claude starts guided planning
Claude: "I'll help you plan this. Let me ask some questions..."
[Questions about OAuth vs password, JWT expiry, roles, etc.]

User: [Answers questions]

# Claude generates plan
Claude: "Plan created at .claude/parallel-dev/plans/auth-system.md"

# User reviews and approves
/parallel-dev:plan-show auth-system
/parallel-dev:plan-edit auth-system --approve

# Decompose into tasks
/parallel-dev:decompose auth-system
# Shows: 15 tasks across 4 phases, critical path ~12h

# Start execution
/parallel-dev:start auth-system
# Creates worktree, spawns agents, shows progress

# User can monitor
/parallel-dev:status
# Shows: 45% complete (7/15 tasks), 3 agents active

# Pause if needed
/parallel-dev:pause auth-system

# Resume later
/parallel-dev:resume auth-system

# Validate when complete
/parallel-dev:validate auth-system
# Shows: All checks passed, ready to merge

# Merge to main
/parallel-dev:merge auth-system
# Merges, cleans up worktree, archives execution