Estados
Los siete estados del workflow, sus transiciones, el límite de un in_progress y --force.
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.
| Estado | Significado | Carácter |
|---|---|---|
| pending | Work Item creado, pendiente de planificación. | Ciclo |
| ready | Planificación terminada, esperando aprobación humana. | Ciclo |
| in_progress | Implementación en curso. Solo puede haber uno a la vez. | Ciclo |
| review | Implementación finalizada, pendiente de revisión. | Ciclo |
| done | Completado y aprobado; estado terminal. | Terminal |
| blocked | El trabajo no puede continuar. | Rama |
| changes_requested | La 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.
| Desde | Hasta | Tipo | Cuándo |
|---|---|---|---|
| pending | ready | Ciclo | El Spec Author termina la planificación. |
| ready | in_progress | Ciclo | Exige aprobación humana explícita. |
| in_progress | review | Ciclo | El Implementer cierra con su reporte. |
| review | done | Ciclo | Veredicto favorable del Reviewer. |
| review | changes_requested | Rama | El Reviewer rechaza la implementación. |
| changes_requested | in_progress | Rama | El Implementer aplica las correcciones. |
| pending | blocked | Rama | El trabajo no puede continuar. |
| ready | blocked | Rama | El trabajo no puede continuar. |
| in_progress | blocked | Rama | El trabajo no puede continuar. |
| review | blocked | Rama | El trabajo no puede continuar. |
| changes_requested | blocked | Rama | El trabajo no puede continuar. |
| done | blocked | Forzada (--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_progressrechaza activar un segundo Work Item, también con--force.rei check,rei doctoryrei items statusfallan si detectan más de uno.rei items statusmarca 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.
rei status set <work-item-id> blocked --forceLas 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_commitpara que la siguiente revisión vea solo lo cambiado.
La firma humana libera la hoja. El silencio no aprueba.