REI HARNESS / DOSSIER DE PRODUCTO

HOJA 02 / 06

v0.3.0 · ES

Producto · Flujo

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

P.01Flujo

Hoja destacada

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.

ciclo · work item

SIMULACIÓN
01 / 06

Paso 01 / 06

Leader

pending

Work Item creado, pendiente de planificación.

Salidas

  • pending → readyCiclo

    El Spec Author termina la planificación.

  • pending → blockedRama

    El trabajo no puede continuar.

Movimiento reducido: recorrido manual.

Simulación: no ejecuta comandos ni aprueba Work Items.

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.

P.02Puerta

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.

P.03Estados

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.

  1. 01pendingWork Item creado, pendiente de planificación.
  2. 02readyPlanificación terminada, esperando aprobación humana.
  3. Aprobación de la planificaciónfirma humanaLa firma humana libera la hoja. El silencio no aprueba.
  4. 03in_progressImplementación en curso. Solo puede haber uno a la vez.
  5. 04reviewImplementación finalizada, pendiente de revisión.
  6. 05doneterminalCompletado y aprobado; estado terminal.

Ramas · fuera del ciclo

  • 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 doctor y rei 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.

P.04Modo directo

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.

  1. 01

    Elegible

    Documentación, erratas, formato, comentarios o ajustes triviales sin cambio de comportamiento.

  2. 02

    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.

  3. 03

    Autorización

    El Leader pide confirmación explícita e informa de que no habrá planificación, rama ni registro.

  4. 04

    Sin registro

    La única traza es el diff o commit y la conversación; no se escribe current.md, meta.json ni history.md.

  5. 05

    Entrega

    Sin una orden explícita no hay commit, push, PR ni merge.

P.05Contexto

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.