Primer Work Item
Recorre el ciclo completo una vez: inicializar el arnés, personalizar el proyecto, planificar, aprobar, implementar y revisar.
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.
rei init2. 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.
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.
rei status set 2026-10-27_01-54__mi-feature ready5. 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.
rei status set 2026-10-27_01-54__mi-feature in_progress6. 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/.
rei checkrei 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.
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-featureLa firma humana libera la hoja. El silencio no aprueba.