Qué es REI
Qué es REI Harness, qué problema resuelve y por qué el proceso importa antes que los comandos.
Fuente: README.md, docs/product-strategy.md y .rei/docs/
El problema: decidir, planificar y ejecutar en la misma conversación
Cuando decidir qué se construye, planificar cómo y ejecutar el cambio viven en la misma conversación, nada queda registrado y nadie puede revisar la decisión. La IA acelera la escritura, pero no garantiza que se esté construyendo lo correcto.
Desarrollo a ciegas
Se escribe antes de que el alcance esté claro.
Alucinaciones
APIs o datos inventados presentados como ciertos.
Decisiones no autorizadas
Arquitectura o alcance cambiados sin aprobación.
Acciones fuera de límite
Entornos y datos que no se deberían tocar.
Retrabajo
Código rápido y caro de corregir.
La propuesta: especificación, aprobación humana y evidencia
REI Harness es un arnés de Spec Driven Development que se instala en cualquier repositorio y coordina agentes de IA con una puerta de aprobación humana obligatoria. Separa decidir, planificar y ejecutar, y deja el rastro en el propio repositorio.
Especificación primero
La planificación existe antes de la primera línea de código.
Ningún Work Item pasa a implementación sin una firma explícita; el silencio no aprueba.
Roles separados
Leader, Spec Author, Implementer y Reviewer tienen contrato propio; el Initializer personaliza la documentación del proyecto.
Guardarraíles
Alcance definido, verificación obligatoria y reglas duras.
Trazabilidad
Planificación, progreso, decisiones e historial viven en
.rei/.Documentación viva
Lo que la web afirma se puede rastrear al repositorio o a una fuente citada.
Runtime-agnóstico y local-first
El contrato de rol y el CLI son el valor; el adaptador es opcional.
Evidencia externa
La adopción de IA es mayoritaria y la desconfianza en su exactitud también. La web no fabrica cifras propias: cada caso enlaza a su fuente y se limita a lo que el estudio muestra.
Un agente eliminó una base de datos de producción durante un code freeze, ejecutó comandos destructivos sin autorización y generó datos falsos.
Es el caso más claro de por qué hacen falta aprobación humana, entornos separados y límites de acción.
Estudio aleatorizado con desarrolladores open source experimentados: con IA tardaron un 19 % más, aunque creían haber sido un 20 % más rápidos.
La percepción de productividad no es evidencia. Hay que medir y verificar.
Más duplicación, más copy/paste, más churn y menos refactorización a medida que crece la autoría de IA.
La velocidad sin diseño degrada el mantenimiento.
Alrededor del 45 % de las tareas de generación de código introdujeron una vulnerabilidad conocida; la seguridad no mejora necesariamente con modelos más grandes.
La revisión y los guardarraíles no son opcionales.
La adopción de IA se asocia a más throughput y a menor estabilidad de entrega: la IA amplifica las fortalezas y debilidades del sistema.
El proceso existente decide el resultado, no la herramienta.
84 % usa o planea usar IA; 46 % desconfía de la exactitud de sus resultados y solo 3 % confía mucho.
Existe demanda de confianza verificable, no solo de velocidad.
En una tarea acotada, el grupo con Copilot terminó un 55,8 % más rápido.
La IA sí acelera tareas concretas; el problema es la falta de proceso.
Principios de producto
El porqué antes del qué
El proceso y el problema justifican los comandos.
La aprobación humana es el producto
El flujo hace visible la puerta, no la esconde.
La documentación es la fuente de verdad
Cada afirmación se puede rastrear.
Mostrar límites da confianza
El visor es de solo lectura, GitHub Issues es opcional y el modo directo tiene restricciones.
Una sola fuente por dato y dependencias mínimas
Comandos, estados y roles se definen una vez.
Lo que REI no es
No es un generador de código
Ni un agente autónomo que trabaja solo.
No es el repositorio del CLI
El código vive en su propio repositorio y esta web lo documenta.
No es el visor de specs
rei viewes local y de solo lectura.No es un panel de control
La web no ejecuta comandos ni modifica Work Items.
No es un escaparate de métricas
Sin clientes, testimonios ni cifras no demostrables.
Para quién
Desarrollador individual
Dejar de improvisar con el agente sin montar un proceso pesado.
Revisor o aprobador
Ver qué se va a hacer antes de que se escriba y poder rechazarlo.
Equipo con varios runtimes
Un contrato de rol común para OpenCode, Claude Code, Cursor y Codex.
Mantenedor
Referencia pública de comandos, estados y contratos.
Escéptico
Límites y evidencia: qué hace y qué no hace.
Fortalezas diferenciales
SDD desde el minuto 0
El código no empieza hasta que existe una planificación aprobada.
Aprobación humana obligatoria
Ningún Work Item pasa a implementación sin decisión explícita; el silencio no aprueba.
Roles explícitos y separados
Cada rol tiene contrato y no invade el trabajo del otro.
Guardarraíles
Alcance definido, verificación obligatoria, revisión por diff y reglas duras.
Trazabilidad
Planificación, progreso y decisiones quedan en el repositorio, no en el chat.
Documentación viva
La fuente de verdad es el repositorio y se actualiza con el trabajo.
Runtime-agnóstico
El valor está en el contrato de rol y el CLI; el adaptador es opcional.
GitHub Issues opcional
Issues, ramas y PR son una proyección del trabajo, no la fuente de verdad.
Binario único
Un solo ejecutable sin dependencias de runtime.
Local-first
Todo ocurre en la máquina y el repositorio del usuario; el CLI no llama a servicios externos.
Dependencias mínimas
La plataforma y el código propio antes que librerías de terceros.