Orchestrate parallel agent execution with git worktrees
Executes parallel agent tasks using git worktrees and monitors progress.
/plugin marketplace add jpoutrin/product-forge/plugin install product-design@product-forge-marketplace<parallel-dir> [--validate] [--status]Category: Parallel Development
/parallel-run <parallel-dir> [options]
<parallel-dir>: Required - Path to decomposed parallel folder (e.g., parallel/TS-0042-inventory/)--validate: Only validate the directory without executing--status: Show current execution statusExecute parallel agent development tasks using the cpo (Claude Parallel Orchestrator) CLI tool. This command:
/parallel-decompose first (creates tasks, prompts, manifest.json)cpo tool installed: pip install claude-parallel-orchestrator or pipx install claude-parallel-orchestratorclaude --versionWhen this command is run, Claude Code should delegate to the cpo CLI tool.
Extract from user input:
PARALLEL_DIR: The parallel directory pathVALIDATE_ONLY: Boolean, true if --validate specifiedSTATUS_ONLY: Boolean, true if --status specifiedcpo --help
If cpo is not installed, display:
ERROR: cpo (Claude Parallel Orchestrator) not found
Install with:
pip install claude-parallel-orchestrator
# or
pipx install claude-parallel-orchestrator
Documentation: https://github.com/jpoutrin/claude-parallel-orchestrator
If --validate is specified:
cpo validate "$PARALLEL_DIR"
Display the validation output and stop.
If --status is specified:
cpo status "$PARALLEL_DIR"
Display the status output and stop.
For default execution (no special flags):
cpo run "$PARALLEL_DIR"
The cpo run command will:
$PARALLEL_DIR/logs/$PARALLEL_DIR/report.jsonThe cpo run command outputs progress to stdout. Parse and display:
=== Parallel Execution Started ===
Wave 1:
task-001-users: RUNNING
task-002-products: RUNNING
task-003-shared: RUNNING
[... cpo output continues ...]
=== Execution Complete ===
Results:
Completed: 5/5 tasks
Failed: 0 tasks
Next step: /parallel-integrate --parallel-dir $PARALLEL_DIR
The cpo tool expects manifest.json with this structure:
{
"tech_spec_id": "TS-0042",
"waves": [
{
"number": 1,
"tasks": [
{
"id": "task-001-users",
"agent": "python-experts:django-expert",
"prompt_file": "prompts/task-001.txt"
},
{
"id": "task-002-products",
"agent": "python-experts:django-expert",
"prompt_file": "prompts/task-002.txt"
}
],
"validation": "python -c 'from apps.users.models import User'"
},
{
"number": 2,
"tasks": [
{
"id": "task-004-orders",
"agent": "python-experts:django-expert",
"prompt_file": "prompts/task-004.txt"
}
],
"validation": "pytest apps/orders/tests/ -v"
}
]
}
Key fields:
tech_spec_id: Links to Tech Spec for traceabilitywaves[].number: Wave execution order (1, 2, 3...)waves[].tasks[].id: Unique task identifierwaves[].tasks[].agent: Agent type from product-forge (e.g., python-experts:django-expert)waves[].tasks[].prompt_file: Path to task prompt filewaves[].validation: Optional command to validate wave completionERROR: cpo command not found
Install with:
pip install claude-parallel-orchestrator
Or check PATH if already installed:
which cpo
ERROR: manifest.json validation failed
Missing required fields:
- tech_spec_id
- waves
Run '/parallel-decompose' to regenerate the manifest.
The cpo tool handles:
Check $PARALLEL_DIR/logs/ for detailed agent output.
Check $PARALLEL_DIR/report.json for execution summary.
# Execute parallel tasks (default)
/parallel-run parallel/TS-0042-inventory/
# Validate manifest without executing
/parallel-run parallel/TS-0042-inventory/ --validate
# Check current execution status
/parallel-run parallel/TS-0042-inventory/ --status
/parallel-setup - One-time project initialization/parallel-decompose - Create tasks and prompts (run before this)/parallel-validate-prompts - Validate prompts have required sections/parallel-integrate - Verify integration (run after this)For advanced usage, use cpo directly:
# Initialize new parallel directory
cpo init parallel/TS-0042-feature -t TS-0042 -n feature-name
# Validate directory structure
cpo validate parallel/TS-0042-feature
# Run parallel execution
cpo run parallel/TS-0042-feature
# Check execution status
cpo status parallel/TS-0042-feature