Conceptos · Aprobación

Aprobación humana

Qué significa aprobar una planificación, qué no significa y cómo se registra la puerta desde el CLI.

Una puerta real · ready → in_progress

La puerta de aprobación

Cuando el Spec Author termina, el Work Item queda en ready. Ese estado no es una sala de espera técnica: es el punto donde la persona revisa la planificación y decide si se implementa o no. Ningún Work Item avanza de ready a in_progress sin una decisión humana explícita.

La puerta existe porque la responsabilidad de qué se construye no es del agente. El Leader coordina y el Spec Author propone, pero el acuerdo sobre el alcance, las decisiones de diseño y los requisitos es de quien encarga el trabajo.

Qué significa aprobar

Aprobar no es revisar código: todavía no existe. Es confirmar que la planificación refleja el acuerdo alcanzado y que las decisiones que determinan el resultado son correctas.

  • Que los requisitos describen el comportamiento que se espera.
  • Que las decisiones de diseño y las alternativas descartadas tienen sentido.
  • Que las tareas cubren el alcance y dejan claro cómo se verificará.
  • Que lo que queda fuera de alcance también es lo acordado.

Aprobar es un acto de responsabilidad, no un visto bueno automático. Si la planificación no refleja lo hablado, el paso correcto es pedir cambios, no aprobar y corregir después.

Lo que no significa aprobar

  • El silencio no aprueba: una respuesta ambigua tampoco. Sin una confirmación inequívoca, el Work Item se queda en ready.
  • Abrir el visor no aprueba: rei view es de solo lectura y no tiene botón ni ruta de aprobación.
  • Leer la planificación no aprueba: la decisión se comunica y se registra, no se deduce.
  • Aprobar no bloquea cambios futuros: si la implementación se desvía, el Reviewer puede rechazarla.

Cómo se registra desde el CLI

La aprobación se da en el chat o en la terminal. El Leader registra el cambio de estado; la persona no necesita ejecutar nada, aunque puede hacerlo si trabaja directamente con el CLI.

Shell
rei status set 2026-10-27_01-54__mi-feature in_progress

Al aprobar, el Leader registra también el commit de inicio de la implementación en base_commit. Si la integración con GitHub Issues está activa y el Work Item es una Feature, la puerta issue + rama se resuelve en este mismo momento, antes de mover el estado.

Si no apruebas

Si algo no refleja lo acordado o una decisión de diseño no te convence, dilo en lenguaje natural. El Leader relanza al Spec Author, la planificación se actualiza y vuelve a presentarse. El Work Item no pasa a implementación mientras tanto.

El rechazo en la revisión es otro momento distinto: si el Reviewer encuentra que la implementación no cumple la planificación, el Work Item pasa a changes_requested y vuelve a in_progress con las correcciones. No tienes que gestionar ese bucle: el Leader lo coordina.

Siguiente paso

Si quieres ver la puerta en un ciclo real, empieza por el tutorial. Si ya trabajas con Work Items, la guía de GitHub Issues explica cómo la puerta convive con issue y rama.

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.