Saltar a contenido

rai pipeline

Ejecuta y gestiona pipelines declarativos. Los pipelines orquestan skills en secuencias automatizadas con gates de calidad.

No disponible en 3.0

Los comandos CLI rai pipeline descritos en esta página aún no están disponibles en RaiSE 3.0. La orquestación de pipelines en 3.0 se ejecuta exclusivamente a través del servidor MCP rai-workspace. Usa las herramientas MCP (pipeline_start, pipeline_advance, pipeline_status, etc.) desde un agente con rai-workspace configurado.

Claude Code lee .mcp.json. Codex lee .codex/config.toml, generado por rai init --agent codex; rai doctor reporta si Codex expone las herramientas MCP de pipeline requeridas.

Consulta el Inicio Rápido de Pipeline para instrucciones de uso.

rai pipeline run

Ejecuta un pipeline por nombre.

Flag Corta Descripción
NAME Nombre del pipeline (posicional, requerido). Ej. story, epic, bugfix
--issue -i ID de issue para trazabilidad (ej. RAISE-1234)
--story-type -t Tipo de story: code, docs, analysis. Por defecto: code
# Ejecutar un pipeline de story
rai pipeline run story --issue RAISE-1234

# Ejecutar para una story de documentación (omite las fases AR/QR)
rai pipeline run story --issue RAISE-1235 --story-type docs

# Ejecutar un pipeline de epic
rai pipeline run epic --issue RAISE-1100

# Ejecutar un pipeline de bugfix
rai pipeline run bugfix --issue RAISE-1300

La salida muestra cada fase con su estado, duración y resultados de gates:

Pipeline: story (8 phases)
Issue:    RAISE-1234
Delegation: review

  [1/8] start.......................... PASSED  (12.3s)
  [2/8] design......................... PASSED  (45.1s)
        gate: PASSED
  [3/8] plan........................... PASSED  (28.7s)
  ...

COMPLETED  8/8 phases passed  (342.1s total)

rai pipeline list

Lista todos los pipelines disponibles desde la jerarquía de carga de 3 niveles.

rai pipeline list
Available Pipelines
┌──────────┬──────────────────────────────────┬────────┬──────────┐
│ Name     │ Description                      │ Phases │ Source   │
├──────────┼──────────────────────────────────┼────────┼──────────┤
│ story    │ 8-phase story lifecycle pipeline  │ 8      │ built-in │
│ epic     │ 6-phase epic lifecycle pipeline   │ 6      │ built-in │
│ bugfix   │ 7-phase bugfix lifecycle pipeline │ 7      │ built-in │
│ hotfix   │ Minimal hotfix pipeline           │ 3      │ built-in │
│ deploy   │ 3-phase deployment pipeline       │ 3      │ project  │
└──────────┴──────────────────────────────────┴────────┴──────────┘

Fuentes: built-in (incluido), project (.raise/pipelines/), user (~/.rai/pipelines/).


rai pipeline resume

Reanuda una ejecución de pipeline pausada después de un gate HITL.

Flag Corta Descripción
RUN_ID ID de ejecución (posicional, requerido)
--decision -d Decisión: approve, revise, reject
# Aprobar y continuar a la siguiente fase
rai pipeline resume abc123 --decision approve

# Solicitar revisiones (re-ejecuta la fase actual)
rai pipeline resume abc123 --decision revise

# Rechazar y detener el pipeline
rai pipeline resume abc123 --decision reject

El ID de ejecución se muestra cuando un pipeline se pausa en un gate HITL.


Niveles de Delegación

Tu nivel de delegación se resuelve desde tu perfil de desarrollador (~/.rai/developer.yaml) y controla el comportamiento de los gates HITL:

Nivel Comportamiento del gate ShuHaRi
review Se pausa en cada gate HITL Shu
notify Continúa y te notifica Ha
auto Continúa en silencio Ri

Los gates marcados como mandatory: true siempre se pausan, independientemente del nivel de delegación.


Persistencia de Estado

El estado del pipeline se almacena en .rai-state/ como JSON. Las ejecuciones sobreviven a:

  • Reinicios de terminal
  • Compactación de contexto
  • Reinicios del servidor MCP

Usa rai pipeline resume para continuar una ejecución pausada después de cualquier interrupción.