Tu agente escribe. Tú decides.
REI Harness convierte el trabajo con agentes de IA en un proceso con especificación, aprobación humana y evidencia, dentro de tu propio repositorio.
Matriz de responsabilidades
| Fase | Leader | Spec Author | Implementer | Reviewer |
|---|---|---|---|---|
| Responsable | No interviene | No interviene | No interviene | |
| No interviene | Responsable | No interviene | No interviene | |
| No interviene | No interviene | Responsable | No interviene | |
| No interviene | No interviene | No interviene | Responsable | |
La firma humana libera la hoja. El silencio no aprueba. | ||||
El mismo caso, dos resultados
Los agentes de IA y los LLM escriben código a partir de una conversación. Cuando decidir, planificar y ejecutar viven en la misma conversación, nada queda registrado y nadie puede revisar la decisión. El arnés separa esas tres cosas y deja la decisión por escrito.
La conversación decide por ti
Mismo caso: «añade un filtro por estado al listado». Sin alcance escrito, el agente empieza por el código.
Alcance tardío
El LLM escribe el filtro antes de que el alcance esté claro: nadie acordó dónde entra ni qué estados cubre.
Alucinaciones
Inventa una API o un dato y lo presenta como cierto.
Decisiones no autorizadas
Cambia la arquitectura o el alcance sin una aprobación que lo respalde.
Acciones fuera de límite
Toca datos o entornos que no le corresponden para probar el cambio.
Retrabajo
El código rápido es caro de corregir; la decisión solo existió en el chat.
Ejemplo de mecanismo; no reproduce una conversación real.
La hoja decide antes del código
El mismo caso entra en un Work Item: planificación revisable, firma humana y evidencia en el repositorio.
Work Item
El Leader registra el alcance, el tipo y el estado pending antes de escribir código.
Planificación
El Spec Author entrega requirements, design y tasks revisables.
Aprobación
La persona revisa y firma; el CLI registra el paso a in_progress. El silencio no aprueba.
Implementación
El Implementer ejecuta solo la planificación aprobada y deja evidencia de verificación.
Revisión
El Reviewer verifica contra la planificación; done exige un veredicto favorable.
Ejemplo de mecanismo construido con los estados y roles reales del arnés.
Una hoja, una firma, evidencia
REI no frena al agente: le da un proceso. Separa decidir, planificar y ejecutar; cada etapa deja un artefacto que se puede leer y revisar.
Recorrer el primer Work ItemEspecificación primero
La planificación existe antes de que el agente escriba la primera línea.
Aprobación humana
Ningún Work Item pasa a implementación sin una firma explícita.
Roles separados
Leader, Spec Author, Implementer y Reviewer no invaden su trabajo.
Evidencia versionada
Planificación, progreso e historial viven en
.rei/, no en el chat.
La aprobación no es un trámite
Un Work Item recorre cinco estados. La puerta no está antes ni después del trabajo: está entre la planificación y el código. Ningún control de esta página aprueba; la firma se registra desde el CLI.
Los artefactos de la puerta son legibles sin JavaScript; el ciclo se lee de arriba abajo en móvil.
pending
El Leader registra el Work Item y acuerda el alcance.
ready
El Spec Author entrega requisitos, diseño y tareas revisables.
La firma humana libera la hoja. El silencio no aprueba.
requirements.md
Qué debe cumplirse y cómo se verifica.
design.md
Cómo se resuelve y qué alternativas se descartaron.
tasks.md
Orden de ejecución con tareas marcables.
La firma se registra desde el CLI; esta página no aprueba.
in_progress
El Implementer ejecuta solo la planificación aprobada.
review
El Reviewer verifica contra la planificación y los checkpoints.
done
Estado terminal: trabajo aprobado y evidencia en el repositorio.
blockedEl trabajo no puede continuar.
changes_requestedLa revisión rechazó la implementación y pide cambios.
Ramas, no atajos. Solo un Work Item puede estar in_progress a la vez.
Roles explícitos, límites explícitos
Cada rol recibe un contrato propio y no invade el trabajo de otro. Abre cualquier rol —también con teclado— para leer su responsabilidad y su límite.
La puerta ocupa el lugar entre Spec Author e Implementer; el Initializer es una rama lateral que no recorre el ciclo del Work Item. Los adaptadores nativos de OpenCode y Claude Code son opcionales; Cursor y Codex funcionan por fallback.
Leader
Comprende la solicitud, elige el workflow y coordina a los demás roles.
No implementa salvo en el modo directo autorizado.
Spec Author
Convierte un Work Item pendiente en una planificación técnica revisable.
Nunca implementa.
Aprobación de la planificación
Implementer
Implementa únicamente la planificación aprobada y deja evidencia de verificación.
No cambia el alcance ni la planificación.
Reviewer
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.
No implementa código ni escribe fuera de los documentos de personalización.
El Initializer prepara el repositorio; no aprueba ni implementa Work Items.
La terminal deja lo que el chat no deja
Una instantánea real de rei items status junto al árbol de planificación del Work Item. No hay vídeo ni reproducción simulada: el texto es el que produjo el CLI.
La captura está fechada (2026-10-27); los estados cambian con el tiempo.
- rei items status
- Work Items:
- - 2026-10-27_00-31__estrategia-producto-web [done] (type: task)
- - 2026-10-27_01-54__fundaciones-visuales-shell-docs [done] (type: feature)
- - 2026-10-27_02-59__tests-logica-jest [done] (type: task)
- - 2026-10-27_03-17__contenido-producto-flujo [done] (type: feature)
- - 2026-10-27_11-04__pulido-home-copy-aprobacion [done] (type: task)
- - 2026-10-27_11-36__conceptos-guias-docs [done] (type: feature)
- - 2026-10-27_12-08__referencia-operacion-docs [done] (type: feature)
- - 2026-10-27_20-34__pulido-hero-inline-github-issues [done] (type: task)
- - 2026-10-27_22-04__home-demostrativa-playwright [in_progress] (type: feature) << ACTIVO
- Solo un Work Item puede estar in_progress a la vez.
rei items status en este repositorio. El estado de los Work Items cambia con el tiempo.Desliza o usa las flechas para ver la línea completa..rei/specs/<id>/
requirements.md
Qué debe cumplirse y cómo se verifica.
design.md
Cómo se resuelve; alternativas descartadas.
tasks.md
Orden de ejecución con tareas marcables.
meta.json
id, tipo, estado, commit base y revisión.
rei view muestra el Work Item, no lo aprueba
Una captura real del visor local: documentos renderizados, tabla de contenidos, validación y FICHA. Es de solo lectura y no tiene botones que finjan aprobar.
Captura tomada con pnpm capture:evidence el 2026-10-27; el visor se sirve en local y no forma parte de la web.

El índice lista los documentos del Work Item; los que no existen se marcan como «no existe».
El visor muestra el resultado de los checkpoints junto a la FICHA, con el estado real del trabajo.
Tipo, estado, fecha y enlaces del Work Item. No hay botón ni ruta de aprobación.

Si hay cambios respecto de la base de revisión, el visor los publica; aquí aparecen como líneas añadidas.
Diff del visor para requirements.md: Cambios +48 / −0.
El recorte muestra el inicio del diff; la captura completa queda en la evidencia del Work Item. Ver captura completa
GitHub Issues es una proyección, no la fuente de verdad
La integración es opcional y no cambia dónde vive el estado. Estas son capturas reales de las issues públicas del repositorio de REI Harness: están cerradas y se muestran con su estado publicado.
El CLI nunca llama a GitHub: lo hacen gh y git bajo orden explícita del Leader.
.rei/specs/<id>/
Planificación, progreso e historial viven en el repositorio, no en la issue.
Existe, se asigna y se cierra como reflejo del Work Item.
Contiene el trabajo que el Reviewer verifica.
Propone el cambio; `.rei` sigue mandando sobre el estado.
Integración opcional: se activa con rei github enable y el flujo funciona sin ella.
![Cuerpo de la GitHub Issue #3 «[prueba v2] Épica: módulo de prueba» con su task list publicada.](/_next/image?url=%2Fevidence%2Fgh-3-body.png&w=3840&q=75)
Lo que la web no hace
Mostrar los límites forma parte de la propuesta: la web documenta el arnés, no lo sustituye.
Consultar los comandosSin búsqueda ni selector de versiones
La navegación, el TOC y una estructura de URLs predecible cubren el volumen actual.
El visor es de solo lectura
La aprobación se registra desde el CLI, no desde el navegador.
GitHub Issues es opcional
No es la fuente de verdad del Work Item ni un requisito para trabajar.
El modo directo está restringido
Solo aplica a cambios triviales solicitados explícitamente.
La web no ejecuta comandos
No modifica Work Items ni sustituye al CLI o al visor.
Instala REI y abre tu primer Work Item
Tu agente escribe; tú decides. Un binario, un comando y una planificación aprobada antes de implementar. La evidencia queda en tu repositorio.


![Cabecera de la GitHub Issue #3 «[prueba v2] Épica: módulo de prueba» con estado Closed y etiquetas rei, rei:epic.](/_next/image?url=%2Fevidence%2Fgh-3-head.png&w=3840&q=75)

![Cabecera de la GitHub Issue #5 «[prueba v2] Hija B: asignación y lote» con estado Closed y etiquetas rei, rei:backlog.](/_next/image?url=%2Fevidence%2Fgh-5-head.png&w=3840&q=75)