Referencia · Estados

Estados

Los siete estados del workflow, sus transiciones, el límite de un in_progress y --force.

siete estados · transiciones · un solo in_progress

Los siete estados

Todo Work Item, sea Feature o Task, recorre los mismos estados. Cinco forman el ciclo lineal y dos son ramas fuera de él.

EstadoSignificadoCarácter
pendingWork Item creado, pendiente de planificación.Ciclo
readyPlanificación terminada, esperando aprobación humana.Ciclo
in_progressImplementación en curso. Solo puede haber uno a la vez.Ciclo
reviewImplementación finalizada, pendiente de revisión.Ciclo
doneCompletado y aprobado; estado terminal.Terminal
blockedEl trabajo no puede continuar.Rama
changes_requestedLa revisión rechazó la implementación y pide cambios.Rama

Transiciones

La tabla se genera desde el dato canónico del arnés. Las salidas a blocked se derivan de todos los estados no terminales; done solo puede salir con una transición forzada.

DesdeHastaTipoCuándo
pendingreadyCicloEl Spec Author termina la planificación.
readyin_progressCicloExige aprobación humana explícita.
in_progressreviewCicloEl Implementer cierra con su reporte.
reviewdoneCicloVeredicto favorable del Reviewer.
reviewchanges_requestedRamaEl Reviewer rechaza la implementación.
changes_requestedin_progressRamaEl Implementer aplica las correcciones.
pendingblockedRamaEl trabajo no puede continuar.
readyblockedRamaEl trabajo no puede continuar.
in_progressblockedRamaEl trabajo no puede continuar.
reviewblockedRamaEl trabajo no puede continuar.
changes_requestedblockedRamaEl trabajo no puede continuar.
doneblockedForzada (--force)Transición no estándar: exige --force y una orden explícita.

Un solo in_progress

El límite es duro: solo puede existir un Work Item en in_progress. No es una recomendación de estilo ni una convención que el agente pueda saltarse.

  • rei status set <id> in_progress rechaza activar un segundo Work Item, también con --force.
  • rei check, rei doctor y rei items status fallan si detectan más de uno.
  • rei items status marca el Work Item activo con << ACTIVO y nombra los implicados cuando hay conflicto.
  • Antes de iniciar otro, hay que cerrar el activo (review o done), bloquearlo o revisarlo.

done es terminal

done cierra el Work Item: no se sale de él por una transición estándar. La única salida es done → blocked con --force, reservada a una transición no estándar con una orden explícita del usuario.

Transición forzada
rei status set <work-item-id> blocked --force

Las ramas

blocked y changes_requested describen trabajo detenido, no estados de éxito. El Work Item sigue existiendo y conserva su planificación e historial.

  • blocked se alcanza desde cualquier estado no terminal cuando el trabajo no puede continuar; se sale con la causa resuelta.
  • changes_requested lo produce un rechazo del Reviewer en review. El Work Item vuelve a in_progress con las correcciones solicitadas.
  • En changes_requested, el Reviewer registra last_review_commit para que la siguiente revisión vea solo lo cambiado.

Aprobación de la planificación

Pendiente

La firma humana libera la hoja. El silencio no aprueba.

La aprobación se registra desde el CLI; el visor no la sustituye.