Cómo funciona
El flujo completo de un Work Item, la puerta de aprobación humana, los estados y el modo directo.
Un Work Item · una puerta · un solo in_progress
De la solicitud al cierre
Un Work Item recorre el mismo flujo tanto si es una Feature como si es una Task. Lo que cambia es la planificación que genera el Spec Author: requisitos, diseño y tareas para una Feature; un plan breve para una Task.
pending
Work Item creado, pendiente de planificación.
pending → ready
El Spec Author termina la planificación.
pending → blocked
El trabajo no puede continuar.
La ventana es una simulación automática: al entrar en pantalla recorre las seis paradas y se detiene en la puerta para escenificar la firma. El cursor, el botón «Aprobar» y el check son fingidos; la aprobación real es humana y se registra desde el CLI. Puedes pausarla o recorrer las paradas a mano: la simulación no ejecuta comandos ni aprueba Work Items. La tabla de estados de más abajo conserva el registro completo.
El estado del trabajo no vive en la conversación: meta.json registra la etapa de cada Work Item y current.md refleja la sesión activa para poder retomarla.
La puerta de aprobación
La puerta es real: el Work Item queda en ready hasta que la persona revisa la planificación y decide. La aprobación se da en el chat o en la terminal, y el Leader registra el paso con rei status set <id> in_progress. El visor no la sustituye.
Estados y ramas
El ciclo tiene cinco estados y dos ramas. blocked y changes_requested no son atajos: describen trabajo que no puede continuar o una revisión que exige correcciones.
- pendingWork Item creado, pendiente de planificación.
- readyPlanificación terminada, esperando aprobación humana.
- Aprobación de la planificaciónLa firma humana libera la hoja. El silencio no aprueba.
- in_progressImplementación en curso. Solo puede haber uno a la vez.
- reviewImplementación finalizada, pendiente de revisión.
- doneCompletado y aprobado; estado terminal.
- blockedEl trabajo no puede continuar.
- changes_requestedLa revisión rechazó la implementación y pide cambios.
Ramas, no atajos: describen trabajo detenido o una revisión que exige correcciones.
- Solo puede existir un Work Item in_progress a la vez. El límite lo aplican
rei status set,rei check,rei doctoryrei items status. - done es terminal: no se sale de él por una transición estándar.
- Si el Reviewer rechaza, el Work Item pasa a changes_requested y vuelve a in_progress con las correcciones.
- Si el trabajo no puede continuar en cualquier punto, pasa a blocked.
Modo directo autorizado
Existe una vía fuera del workflow para cambios triviales solicitados explícitamente. No es un tipo de Work Item ni un estado: trabaja sobre la rama y el árbol actuales, y no crea Work Item, planificación, sesión, issue ni rama.
Elegible
Documentación, erratas, formato, comentarios o ajustes triviales sin cambio de comportamiento.
Negativa
Si afecta comportamiento, seguridad, datos, dependencias, API pública, arquitectura, más de un archivo o necesita especificación o revisión, el Leader se niega y ofrece una Task o una Feature.
Autorización
El Leader pide confirmación explícita e informa de que no habrá planificación, rama ni registro.
Sin registro
La única traza es el diff o commit y la conversación; no se escribe
current.md,meta.jsonnihistory.md.Entrega
Sin una orden explícita no hay commit, push, PR ni merge.
Cómo encaja con la home y la documentación
La home presenta el producto; esta sección explica el mecanismo y la puerta; la documentación enseña tareas concretas. Ninguna de las tres duplica a las otras.