REI HARNESS / DOSSIER DE PRODUCTO

HOJA 03 / 06

v0.3.0 · ES

Producto · Roles

Agentes

Los cinco roles de REI Harness, su responsabilidad, su límite y el momento en que intervienen.

Cinco roles · contratos explícitos

P.01Roles

Hoja destacada

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.

  1. 01

    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.

    Límite · No implementa salvo en el modo directo autorizado.

  2. 02

    Spec Author

    Cuando el Work Item está en pending y toca planificarlo.

    Convierte un Work Item pendiente en una planificación técnica revisable.

    Límite · Nunca implementa.

  3. Aprobación de la planificación

    Pendiente

    La firma humana libera la hoja. El silencio no aprueba.

  4. 03

    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.

    Límite · No cambia el alcance ni la planificación.

  5. 04

    Reviewer

    Cuando el Work Item está en review.

    Valida el trabajo contra la planificación y los checkpoints del proyecto.

    Límite · No implementa: aprueba o solicita cambios.

Fuera del ciclo

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.

Initializer · /personalize

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.

claude code · /personalize

Terminal de Claude Code v2.1.312 con la lista de comandos de proyecto abierta: `/init` y `/personalize`, este descrito como la entrevista de personalización del proyecto (rol initializer).
Captura de un proyecto de ejemplo · el comando no se ejecuta en esta webVer captura completa
La captura muestra Claude Code; los adaptadores nativos exponen el mismo comando. La web solo muestra la evidencia. · captura del 2026-10-28

P.02Ciclo

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.

P.03Contratos

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.

P.04Límites

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.