REI HARNESS / DOSSIER DE PRODUCTO

HOJA 01 / 06

v0.3.0 · ES

Producto · Spec Driven Development

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/

P.01Problema

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.

  1. 01

    Desarrollo a ciegas

    Se escribe antes de que el alcance esté claro.

  2. 02

    Alucinaciones

    APIs o datos inventados presentados como ciertos.

  3. 03

    Decisiones no autorizadas

    Arquitectura o alcance cambiados sin aprobación.

  4. 04

    Acciones fuera de límite

    Entornos y datos que no se deberían tocar.

  5. 05

    Retrabajo

    Código rápido y caro de corregir.

P.02Mecanismo

Hoja destacada

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.

  1. 01

    Especificación primero

    La planificación existe antes de la primera línea de código.

  2. 02

    Aprobación de la planificación

    Ningún Work Item pasa a implementación sin una firma explícita; el silencio no aprueba.

  3. 03

    Roles separados

    Leader, Spec Author, Implementer y Reviewer tienen contrato propio; el Initializer personaliza la documentación del proyecto.

  4. 04

    Guardarraíles

    Alcance definido, verificación obligatoria y reglas duras.

  5. 05

    Trazabilidad

    Planificación, progreso, decisiones e historial viven en .rei/.

  6. 06

    Documentación viva

    Lo que la web afirma se puede rastrear al repositorio o a una fuente citada.

  7. 07

    Runtime-agnóstico y local-first

    El contrato de rol y el CLI son el valor; el adaptador es opcional.

P.03Evidencia

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.

Evidencia externa citada · cada caso enlaza a su fuente

  1. 01

    Incidente de Replit

    Julio de 2025

    Un agente eliminó una base de datos de producción durante un code freeze, ejecutó comandos destructivos sin autorización y generó datos falsos.

    Implicación

    Es el caso más claro de por qué hacen falta aprobación humana, entornos separados y límites de acción.

  2. 02

    METR

    2025

    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.

    Implicación

    La percepción de productividad no es evidencia. Hay que medir y verificar.

  3. 03

    GitClear

    2025–2026

    Más duplicación, más copy/paste, más churn y menos refactorización a medida que crece la autoría de IA.

    Implicación

    La velocidad sin diseño degrada el mantenimiento.

  4. 04

    Veracode

    2025–2026

    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.

    Implicación

    La revisión y los guardarraíles no son opcionales.

  5. 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.

    Implicación

    El proceso existente decide el resultado, no la herramienta.

  6. 84 % usa o planea usar IA; 46 % desconfía de la exactitud de sus resultados y solo 3 % confía mucho.

    Implicación

    Existe demanda de confianza verificable, no solo de velocidad.

  7. En una tarea acotada, el grupo con Copilot terminó un 55,8 % más rápido.

    Implicación

    La IA sí acelera tareas concretas; el problema es la falta de proceso.

P.04Principios

Principios de producto

  1. 01

    El porqué antes del qué

    El proceso y el problema justifican los comandos.

  2. 02

    La aprobación humana es el producto

    El flujo hace visible la puerta, no la esconde.

  3. 03

    La documentación es la fuente de verdad

    Cada afirmación se puede rastrear.

  4. 04

    Mostrar límites da confianza

    El visor es de solo lectura, GitHub Issues es opcional y el modo directo tiene restricciones.

  5. 05

    Una sola fuente por dato y dependencias mínimas

    Comandos, estados y roles se definen una vez.

P.05Límites

Lo que REI no es

  1. No es un generador de código

    Ni un agente autónomo que trabaja solo.

  2. No es el repositorio del CLI

    El código vive en su propio repositorio y esta web lo documenta.

  3. No es el visor de specs

    rei view es local y de solo lectura.

  4. No es un panel de control

    La web no ejecuta comandos ni modifica Work Items.

  5. No es un escaparate de métricas

    Sin clientes, testimonios ni cifras no demostrables.

P.06Audiencias

Para quién

P.07Diferenciales

Fortalezas diferenciales

  1. SDD desde el minuto 0

    El código no empieza hasta que existe una planificación aprobada.

  2. Aprobación humana obligatoria

    Ningún Work Item pasa a implementación sin decisión explícita; el silencio no aprueba.

  3. Roles explícitos y separados

    Cada rol tiene contrato y no invade el trabajo del otro.

  4. Guardarraíles

    Alcance definido, verificación obligatoria, revisión por diff y reglas duras.

  5. Trazabilidad

    Planificación, progreso y decisiones quedan en el repositorio, no en el chat.

  6. Documentación viva

    La fuente de verdad es el repositorio y se actualiza con el trabajo.

  7. Runtime-agnóstico

    El valor está en el contrato de rol y el CLI; el adaptador es opcional.

  8. GitHub Issues opcional

    Issues, ramas y PR son una proyección del trabajo, no la fuente de verdad.

  9. Binario único

    Un solo ejecutable sin dependencias de runtime.

  10. Local-first

    Todo ocurre en la máquina y el repositorio del usuario; el CLI no llama a servicios externos.

  11. Dependencias mínimas

    La plataforma y el código propio antes que librerías de terceros.