The Unread Manifesto
En defensa del Policy-Driven Development
La calidad del software no depende de que una persona lea cada línea, sino de que el sistema garantice que lo que sale es bueno y correcto.
La IA ya escribe gran parte de nuestro código, documentos y planes. Igual que nadie lee el código máquina que genera un compilador, y ningún CTO lee todo el código de su equipo, no hace falta mirar más, hace falta garantizar mejor.
Valoramos
- Resultados verificados sobre líneas leídas
- Especificación clara sobre specs detalladas
- Controles en el sistema sobre confiar en la buena voluntad
- Criterio humano en el qué sobre revisión humana del cómo
- Mejorar el sistema sobre parchear el resultado
En el espíritu del Manifiesto Ágil: lo de la derecha tiene su valor, pero lo de la izquierda vale más.
Creemos
- La calidad nunca ha dependido de leerlo todo. Ningún equipo lo ha hecho. Delegamos en personas con tests, criterios de aceptación y responsables. Con la IA es igual.
- No hay dos desarrolladores que escriban el mismo código. Lo que importa no es cómo está escrito, sino que cumpla lo especificado y se pueda cambiar con seguridad. Por eso las propiedades del diseño también forman parte del contrato.
- El código pasa a ser un producto intermedio, como lo fue el ensamblador. Lo que mantenemos de verdad es la especificación, los tests y las reglas.
- El problema no es lo que nadie ha leído, sino lo que nadie puede verificar. Algo que pasa buenos controles no es slop aunque nadie lo haya leído. Algo que nadie puede comprobar sí lo es, lo haya hecho una persona o un modelo.
- Leer más no escala. Un agente produce en un día más de lo que una persona revisa en meses. Solo escala la revisión que está en el propio sistema.
- Las personas son imprescindibles donde no hay sustituto: entender el dominio, decidir qué se construye, especificarlo bien y responder del resultado.
Nos comprometemos a
- Especificar antes de generar: qué tiene que hacer, cómo se comprueba y qué no puede romperse.
- Tratar los tests como el contrato. Si un módulo se puede regenerar sin tocar sus tests, el código se puede sustituir.
- No dejar entrar nada sin pasar controles: tests, mutation testing, análisis estático y revisión cruzada entre modelos distintos.
- Verificar también los controles: que sean independientes de quien genera, medir si detectan los fallos y mejorarlos como el resto del sistema.
- Poner las reglas en el sistema, no en el prompt. Una instrucción se puede ignorar. Un control que bloquea, no.
- Dejar por escrito lo que no se negocia. Un fallo de seguridad confirmado se arregla, no se discute.
- Registrar cada excepción: quién la concede, qué regla se salta, por qué y hasta cuándo.
- Cambiar el sistema cuando un error aparece dos veces, no solo el resultado.
- Intervenir donde las personas aportan: cuando los controles no se ponen de acuerdo, cuando hay que decidir qué se hace y cuando algo no tiene vuelta atrás.
- Medir lo que importa: qué funciona en producción y a quién ayuda, no líneas, PRs ni tokens.
- Responder de lo que entregamos, lo haya escrito quien lo haya escrito.
En resumen
No pedimos confianza ciega en la IA ni desconfianza por sistema. Pedimos lo que siempre ha funcionado con cualquier equipo: una intención clara, controles que no dependan de la buena voluntad y alguien que responda del resultado. Lo demás lo puede hacer la máquina.