| name | pipeline |
| description | Configurable pipeline orchestrator for sequencing Omagy stages. |
Pipeline Skill
/omagy:pipeline is the configurable pipeline orchestrator for Omagy. It
sequences stages through a uniform stage-result contract, with .omagy state
persistence and resume support.
Default Autopilot Pipeline
The default pipeline sequences:
deep-interview -> ralplan -> ultragoal (+ team if needed) -> code-review -> ultraqa
/omagy:team is conditional: use it only inside an active Ultragoal story when
independent lanes or broad verification make coordinated parallel execution
useful. Explicit legacy Ralph pipelines remain available through custom stage
names, but Ralph is not the advertised default pipeline loop.
Configuration
Pipeline parameters are configurable per run:
| Parameter | Default | Description |
|---|
maxRalphIterations | 10 | Quality-gate retry ceiling; legacy option name retained for parity with OMX |
workerCount | 2 | Number of team workers when the team stage is inserted |
agentType | executor | Agent type hint for team workers |
Stage Interface
Every stage records a stage result:
{
"stage": "code-review",
"status": "completed",
"artifacts": {
"review_verdict": {
"final_recommendation": "APPROVE",
"architecture_status": "CLEAR"
}
}
}
Stages receive accumulated handoff_artifacts from prior stages and record
status, artifacts, and optional duration.
Built-in Stages
- deep-interview: Requirements clarification and ambiguity gate.
- ralplan: Consensus planning. Skips only when planning artifacts already
exist and carries any deep-interview spec paths forward for traceability.
- ultragoal: Durable goal-mode execution with
.omagy ledgers. Launch
/omagy:team only from inside an Ultragoal story when parallel lanes are
warranted.
- code-review: Merge-readiness review gate.
- ultraqa: Adversarial QA gate after a clean review; docs-only or trivially
non-runtime changes may record an explicit skip reason.
- team-exec and ralph-verify: Legacy/custom adapters retained for
explicit non-default pipelines.
State Management
Pipeline state persists at .omagy/state/pipeline-state.json. The HUD and
workflow status read this state through the Omagy mode-state system.
- On start:
omagy pipeline start --input '{"task":"..."}' --json
- On stage transitions:
omagy pipeline record-stage --input '{"stage":"<name>","status":"completed","artifacts":{...}}' --json
- On completion:
omagy pipeline complete --json
- On cancellation:
omagy pipeline cancel --json
Recommended Flow
- Start the pipeline with
omagy pipeline start.
- Run
omagy pipeline next --json to get the current stage handoff.
- Execute the matching
/omagy:<stage> skill.
- Record that stage with concrete artifacts.
- Continue until the pipeline records
current_phase=complete.
Relationship to Other Modes
- autopilot: Autopilot may use pipeline as its execution engine.
- team: Optional execution engine inside an Ultragoal story when parallel
lanes are needed.
- ultragoal: Default durable execution stage.
- ralph: Available only for explicit legacy/custom pipelines.
- ralplan: Pipeline planning runs RALPLAN consensus planning.