Pipeline Skill

$pipeline

PipelineStage

Default Autopilot Pipeline

RALPLAN (consensus planning) -> team-exec (Codex CLI workers) -> ralph-verify (architect verification)

Configuration

maxRalphIterations

workerCount

agentType

executor

Stage Interface

PipelineStage

interface PipelineStage {
  readonly name: string;
  run(ctx: StageContext): Promise<StageResult>;
  canSkip?(ctx: StageContext): boolean;
}

StageContext

StageResult

Built-in Stages

• ralplan: Consensus planning (planner + architect + critic). Skips only when both

  prd-*.md

  and

  test-spec-*.md

  planning artifacts already exist, and carries any

  deep-interview-*.md

  spec paths forward for traceability.
• team-exec: Team execution via Codex CLI workers. Always the OMX execution backend.
• ralph-verify: Ralph verification loop with configurable iteration count.

State Management

.omx/state/pipeline-state.json

• On start:

  state_write({mode: "pipeline", active: true, current_phase: "stage:ralplan"})

• On stage transitions:

  state_write({mode: "pipeline", current_phase: "stage:<name>"})

• On completion:

  state_write({mode: "pipeline", active: false, current_phase: "complete"})

API

import {
  runPipeline,
  createAutopilotPipelineConfig,
  createRalplanStage,
  createTeamExecStage,
  createRalphVerifyStage,
} from './pipeline/index.js';

const config = createAutopilotPipelineConfig('build feature X', {
  stages: [
    createRalplanStage(),
    createTeamExecStage({ workerCount: 3, agentType: 'executor' }),
    createRalphVerifyStage({ maxIterations: 15 }),
  ],
});

const result = await runPipeline(config);

Relationship to Other Modes

• autopilot: Autopilot can use pipeline as its execution engine (v0.8+)
• team: Pipeline delegates execution to team mode (Codex CLI workers)
• ralph: Pipeline delegates verification to ralph (configurable iterations)
• ralplan: Pipeline's first stage runs RALPLAN consensus planning