Empezar · Tutorial

Primer Work Item

Recorre el ciclo completo una vez: inicializar el arnés, personalizar el proyecto, planificar, aprobar, implementar y revisar.

7 pasos · Un Work Item completo

1. Inicializa el arnés

En la raíz de tu proyecto, rei init despliega AGENTS.md y la carpeta .rei/, prepara la estructura de estado e inicializa git si falta. No sobrescribe archivos existentes.

Shell
rei init

2. Personaliza el proyecto

El arnés necesita conocer tu proyecto. En OpenCode o Claude Code puedes ejecutar /personalize; en cualquier runtime, pide al agente «personaliza mi proyecto» y el rol Initializer conducirá la entrevista.

  • Propósito del producto, usuarios y principios.
  • Stack técnico y comandos del proyecto.
  • Decisiones de arquitectura y convenciones.
  • Checkpoints de verificación y checks rápidos.

3. Crea el Work Item

Describe lo que necesitas al agente. Cuando el alcance esté acordado, el Leader crea el Work Item en estado pending con un identificador y un tipo.

Ejemplo
rei new 2026-10-27_01-54__mi-feature feature "Mi primera feature"

Una Feature exige requirements.md, design.md y tasks.md; una Task se planifica con un único plan.md para cambios pequeños y localizados.

4. Planifica

El Spec Author convierte el Work Item en una planificación técnica revisable. No implementa: su entregable son los documentos de decisión.

  • Requisitos observables y verificables.
  • Decisiones de diseño y alternativas descartadas.
  • Tareas ordenadas con su verificación.
Shell
rei status set 2026-10-27_01-54__mi-feature ready

5. Aprueba la planificación

Revisa la planificación antes de que se escriba código. Si estás de acuerdo, la aprobación se registra desde el CLI; si algo no refleja lo acordado, se pide al Spec Author que la actualice.

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

6. Implementa

El Implementer ejecuta solo la planificación aprobada, marca cada tarea al completarla y deja evidencia de verificación en .rei/progress/work-items/.

Shell
rei check

rei check verifica el arnés y ejecuta los checks declarados en .rei/config.json. Los checkpoints lentos, como el build de producción, se ejecutan al cerrar el Work Item.

7. Revisa y cierra

El Reviewer compara el trabajo con la planificación y los checkpoints. Si falta algo, el Work Item pasa a changes_requested y el Implementer corrige; si todo pasa, queda done.

Shell
rei status set 2026-10-27_01-54__mi-feature review
rei review-diff 2026-10-27_01-54__mi-feature
rei validate 2026-10-27_01-54__mi-feature

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.