Saltar a contenido

Pipeline Quickstart

Esta guía te lleva a través de la ejecución de un pipeline de story de extremo a extremo. Al finalizar, entenderás cómo los pipelines secuencian skills, pausan en gates HITL para tu aprobación, y se recuperan entre sesiones.

Prerrequisitos

  • RaiSE inicializado (rai init)
  • Un issue de Jira en el que trabajar (p.ej., RAISE-1234)
  • Claude Code con el servidor MCP rai-workspace conectado

Ejecutar un Pipeline de Story

Dentro de Claude Code, pídele a Rai que inicie el pipeline:

Inicia el pipeline de story para RAISE-1234

Rai llama a la herramienta MCP pipeline_start, que carga la definición del pipeline story.yaml, resuelve tu nivel de delegación y comienza a ejecutar fases:

Pipeline: story (8 fases)
Issue:    RAISE-1234
Delegación: review

  [1/8] start.......................... PASSED  (12.3s)
  [2/8] design......................... PASSED  (45.1s)
        gate: PAUSADO — esperando revisión

En cada fase, Rai lee el SKILL.md correspondiente y sigue sus pasos automáticamente. Permaneces en Claude Code todo el tiempo — no hay nada que ejecutar en una terminal.

Revisión en Gates HITL

Cuando el pipeline llega a un gate, pausa y presenta el output de la fase para tu revisión. Respondes directamente en la conversación:

  • Aprobar — el skill llama a pipeline_advance para avanzar a la siguiente fase
  • Revisar — el skill re-ejecuta la fase con tu feedback
  • Rechazar — el skill llama a pipeline_cancel para detener el pipeline

Los gates son el punto de control clave. Comienza con delegación review para ver cada gate hasta que confíes en el proceso.

Qué Sucede en Cada Fase

Fase Skill Qué hace Gate
start /rai-story-start Crea la branch, commit de scope —
design /rai-story-design Gemba walk, spec lean, ejemplos HITL
plan /rai-story-plan Descompone en tareas atómicas —
implement /rai-story-implement Ejecución TDD de tareas HITL
architecture-review /rai-architecture-review Proporcionalidad + auditoría lean HITL
quality-review /rai-quality-review Bugs semánticos + verificación de patrones HITL
review /rai-story-review Retrospectiva + extracción de patrones —
close /rai-story-close Merge, limpieza, seguimiento —

Las fases con condiciones when (como architecture-review: story_type == 'code') se omiten automáticamente cuando la condición es falsa.

Herramientas MCP Internamente

El slash command orquesta estas herramientas MCP en tu nombre:

Herramienta Propósito
pipeline_start Iniciar una ejecución de pipeline para un issue dado
pipeline_advance Avanzar a la siguiente fase tras la aprobación de un gate
pipeline_status Verificar el estado actual de una ejecución de pipeline
pipeline_pause Pausar un pipeline en ejecución manualmente
pipeline_restore Restaurar un pipeline tras reinicio de sesión o compactación de contexto
pipeline_cancel Detener una ejecución de pipeline
pipeline_list Listar definiciones de pipeline disponibles
pipeline_runs Listar ejecuciones activas y recientes

No necesitas llamar a estas herramientas directamente — el skill lo gestiona. Pero están disponibles si quieres control más granular durante una sesión.

Recuperación de Sesión

Los pipelines sobreviven la compactación de contexto y los reinicios de sesión. El estado se persiste en .rai-state/.

Si inicias una nueva sesión de Claude Code y necesitas retomar:

Retoma mi pipeline para RAISE-1234

Rai llama a pipeline_restore para encontrar la ejecución existente y continúa desde donde se quedó. También puedes verificar el estado explícitamente:

¿Cuál es el estado de mi pipeline para RAISE-1234?

Pipelines Disponibles

El framework incluye varios pipelines built-in:

  • story — ciclo de vida completo de story (8 fases)
  • epic — ciclo de vida de epic con seguimiento de milestones
  • bugfix — corrección de bugs en 7 fases con 3 gates HITL
  • hotfix — corrección expedita para problemas de producción

Los pipelines se cargan desde una jerarquía de 3 niveles:

  1. Built-in — incluidos con rai-agent
  2. Proyecto — definidos en .raise/pipelines/ de tu proyecto
  3. Usuario — definidos en ~/.rai/pipelines/

Los pipelines de proyecto y usuario reemplazan a los built-in con el mismo nombre.

Consejos

  • Comienza con delegación REVIEW — ve cada gate hasta que confíes en el proceso
  • Usa story_type: docs — omite las fases de architecture y quality review (solo se ejecutan para code)
  • Los pipelines no reemplazan los skills — siempre puedes invocar /rai-story-design directamente si prefieres control manual
  • Los artifacts son trazados — cada fase valida que su output existe antes de que se ejecute el gate

Acceso Directo a MCP

Las herramientas MCP listadas arriba están disponibles para uso directo cuando necesitas control más granular. Pídele a Rai que las llame explícitamente, o invócalas desde cualquier cliente compatible con MCP.

Nota: No existe un comando CLI rai pipeline en 3.0. La orquestación de pipelines se ejecuta exclusivamente a través del servidor MCP (rai-workspace). Ver referencia CLI de rai pipeline para soporte CLI planificado.

Próximos Pasos