Agentes
Los cinco roles de REI Harness, su responsabilidad, su límite y el momento en que intervienen.
Cinco roles · contratos explícitos
Cinco roles, cinco límites
REI separa coordinar, planificar, implementar, revisar y personalizar. Cada rol tiene un contrato propio con una responsabilidad, un límite y un momento de intervención; ninguno invade el trabajo del otro.
Leader
Al recibir cada solicitud y durante la coordinación del workflow.
Comprende la solicitud, elige el workflow y coordina a los demás roles.
No implementa salvo en el modo directo autorizado.
Spec Author
Cuando el Work Item está en pending y toca planificarlo.
Convierte un Work Item pendiente en una planificación técnica revisable.
Nunca implementa.
La firma humana libera la hoja. El silencio no aprueba.
Implementer
Cuando el Work Item está en in_progress con una planificación aprobada.
Implementa únicamente la planificación aprobada y deja evidencia de verificación.
No cambia el alcance ni la planificación.
Reviewer
Cuando el Work Item está en review.
Valida el trabajo contra la planificación y los checkpoints del proyecto.
No implementa: aprueba o solicita cambios.
Initializer
Conduce la personalización guiada de la documentación del proyecto tras rei init.
Tras rei init, cuando quedan marcadores pendientes de personalización.
No implementa código ni escribe fuera de los documentos de personalización.
Prepara el repositorio; no aprueba ni implementa Work Items.
Los distintos CLI con adaptador nativo —OpenCode y Claude Code— reconocen /personalize como comando de proyecto: lanza la entrevista del Initializer, que conduce la personalización de la documentación. El Initializer no implementa código ni aprueba Work Items. La captura muestra Claude Code como ejemplo y el comando se ejecuta en el runtime del agente, no en esta web.
Los cuatro roles del ciclo
Leader, Spec Author, Implementer y Reviewer recorren el Work Item de principio a fin. El Initializer queda fuera del ciclo: conduce la personalización guiada de la documentación del proyecto después de rei init, cuando quedan marcadores pendientes.
Contratos y adaptadores
El contrato canónico vive en .rei/agents/. Si el runtime dispone de adaptador nativo, rei init opencode o rei init claude generan un subagente por rol a partir de la sección ## Contrato. Cursor y Codex funcionan por fallback: el Leader transmite únicamente ese contrato, sin configuración adicional.
Los archivos generados llevan la marca GENERATED y la instalación es idempotente: si ya están al día, no se modifican, y nunca se sobrescribe un archivo que no hayan generado. rei init opencode --check o rei init claude --check detectan la deriva sin escribir nada.
Lo que no cambia con el runtime
- El contrato es la fuente; el adaptador es una capa opcional.
- Invocar un subagente directamente no elimina el workflow: el Work Item sigue necesitando planificación y aprobación.
- El Leader transmite al subagente solo el contrato del rol, nunca el archivo completo.
- La instalación de adaptadores es idempotente y no sobrescribe archivos ajenos.
