Pipeline

/pipeline

Launch an automated multi-skill pipeline. The Stop hook chains skills automatically — no manual invocation needed between stages.

Available Pipelines

Research Pipeline

Chains: /research -> /validate Produces: research.md -> prd.md

Dev Pipeline

Chains: /scaffold -> /setup -> /plan -> /build Produces: full project with workflow, plan, and implementation

Steps

1. Parse Arguments

Extract from $ARGUMENTS:

If no arguments or unclear, ask:

Which pipeline do you want to run?
1. Research Pipeline — /research → /validate (idea to PRD)
2. Dev Pipeline — /scaffold → /setup → /plan → /build (PRD to running code)

2. Confirm with User

Show what will happen:

Pipeline: {type}
Stages: {stage1} → {stage2} → ...
Idea/Project: {name}
This will run multiple skills automatically. Continue?

Ask via AskUserQuestion.

3. Start First Stage

Run the first skill in the pipeline directly:

For research pipeline: Run /research "idea name" For dev pipeline: Run /scaffold project-name stack

The Stop hook (if configured) will handle subsequent stages automatically. Without a Stop hook, manually invoke each skill in sequence.

3b. Launcher Scripts (optional, Claude Code plugin only)

If you have the solo-factory plugin installed, launcher scripts provide tmux dashboard and logging:

# Only available with Claude Code plugin — skip if not installed
solo-research.sh "idea name" [--project name]
solo-dev.sh "project-name" "stack" [--feature "desc"]

Pass --no-dashboard when running from within a skill context.

5. Pipeline Completion

When all stages are done, output:

The Stop hook checks for this signal and cleans up the state file.

State File

Location: .solo/pipelines/solo-pipeline-{project}.local.md (project-local) or ~/.solo/pipelines/solo-pipeline-{project}.local.md (global fallback) Log file: .solo/pipelines/solo-pipeline-{project}.log

Format: YAML frontmatter with stages list, project_root, and log_file fields. The Stop hook reads this file on every session exit attempt.

To cancel a pipeline manually: delete the state file solo-pipeline-{project}.local.md

Monitoring

tmux Dashboard (terminal use)

When launched from terminal (without --no-dashboard), a tmux dashboard opens automatically with:

Manual Monitoring

Monitor pipeline progress with standard tools:

# Watch log file
tail -f .solo/pipelines/solo-pipeline-.log
Check pipeline state
Auto-refresh
watch -n2 -c solo-pipeline-status.sh

Otherwise, use standard tools:

# Log tail
tail -f .solo/pipelines/solo-pipeline-.log
Check state file
cat .solo/pipelines/solo-pipeline-.local.md

Session Reuse

Re-running a pipeline reuses any existing state — completed stages are skipped automatically.

Log Format

[22:30:15] START    | my-app | stages: research -> validate | max: 5
[22:30:16] STAGE    | iter 1/5 | stage 1/2: research
[22:30:16] INVOKE   | /research "AI therapist app"
[22:35:42] CHECK    | research | .../research.md -> FOUND
[22:35:42] STAGE    | iter 2/5 | stage 2/2: validate
[22:35:42] INVOKE   | /validate "AI therapist app"
[22:40:10] CHECK    | validate | .../prd.md -> FOUND
[22:40:10] DONE     | All stages complete! Promise detected.
[22:40:10] FINISH   | Duration: 10m

Critical Rules

1. Always confirm before starting a pipeline. 2. Don't skip stages — the hook handles progression. 3. Cancel = delete state file — tell users this if they want to stop. 4. Max iterations prevent infinite loops (default 5 for research, 15 for dev). 5. Use --no-dashboard when running from within Claude Code skill context.