Plan Pipeline

---
name: plan-pipeline
description: "Orchestrates the complete planning pipeline: product direction (ceo-review) → architecture (eng-review) → implementation plan (start) → validation (validate) → execution (execute). Run stages individually or let the orchestrator coordinate the full flow."
allowed-tools: "Read, Write, Bash, Task"
effort: high
---

# Plan Pipeline Orchestrator

Orchestrates the complete plan-to-execution pipeline. Can run the full pipeline or a single isolated stage.

## Stages

| Stage | Skill | Purpose |
|-------|-------|---------|
| 1 | `/plan-pipeline:ceo-review` | Challenge the brief, lock product direction |
| 2 | `/plan-pipeline:eng-review` | Lock architecture, diagrams, and test matrix |
| 3 | `/plan-pipeline:start` | 5-phase planning: PRD, research, ADRs, task list |
| 4 | `/plan-pipeline:validate` | 2-layer validation before any code is written |
| 5 | `/plan-pipeline:execute` | Worktree isolation, parallel agents, quality gate, PR |

## Usage

```
/plan-pipeline                     # full pipeline, asks for context
/plan-pipeline --from=start        # skip gates, start from planning phase
/plan-pipeline --from=validate     # validate an existing plan
/plan-pipeline --from=execute      # execute a validated plan
```

## When to Use Each Stage

**ceo-review** — use before any significant feature when the direction is not locked. Especially valuable when the request is specific (specificity signals collapsed solution space).

**eng-review** — use after direction is locked. Required for features with async components, external dependencies, or multi-step flows.

**start** — use for any non-trivial feature touching more than 2 files or involving architecture decisions.

**validate** — always before execute. The cost of validation is negligible against the cost of discovering issues mid-execution.

**execute** — after validate confirms all issues are resolved.

## Workflow

1. **Collect context** — what are we building, and what stage do we start from?
2. **ceo-review** — product direction gate (can be skipped with `--from=eng-review` or later)
3. **eng-review** — architecture gate (can be skipped with `--from=start` or later)
4. **CHECKPOINT** — ask user to confirm direction and architecture before planning
5. **start** — run 5-phase planning, produce `docs/plans/plan-{name}.md`
6. **CHECKPOINT** — present plan for review before validation
7. **validate** — 2-layer validation (structural + specialist agents)
8. **execute** — worktree isolation → parallel agents → quality gate → PR

## Dependency Graph

```
   ceo-review
        |
   eng-review
        |
      start
        |
    validate
        |
    execute
```

## Notes

Each stage writes its output to disk before the next stage begins. If the pipeline is interrupted, resume with `--from=<stage>` using the correct stage name. All decisions are recorded in `docs/plans/plan-{name}.md` and the corresponding ADRs in `docs/adr/`.