Desarrollo guiado por la duda: que un revisor con contexto nuevo ataque cada decisión importante

Un método de cinco pasos para poner a prueba las decisiones que importan: declarar la tesis, extraer la unidad mínima, pedir un análisis adversarial con contexto nuevo, reconciliar, detenerse.

Metodologíametodologiarevisionequalitàingegneria del software19 de noviembre de 2026 · 3 min de lectura

Quien acaba de tomar una decisión es la peor persona para cuestionarla: ha construido las razones por las que es correcta. Cuando la corrección importa más que la rapidez (producción, seguridad, operaciones irreversibles), conviene que examine la decisión alguien que no conozca el camino que condujo hasta ahí.

El ciclo

1. La tesis. Se escribe en dos o tres líneas lo que se da por cierto y por qué importa: «la nueva capa de caché es segura con cargas de lectura concurrentes; una condición de carrera aquí corrompería los datos y en las pruebas no se ve». Si no se logra escribirla en pocas líneas, no es una decisión, es una impresión.

2. La extracción. Se aísla la unidad más pequeña examinable: el cambio o la función, no el archivo entero; la propuesta en tres-cinco frases con las restricciones que debe respetar. Se entregan el artefacto y el contrato, no el razonamiento. Entregar las conclusiones significa recibir a cambio una confirmación de las conclusiones. Una petición de quinientas líneas debe descomponerse antes.

3. La duda. Un revisor con contexto nuevo (otra persona, un segundo agente iniciado desde cero) recibe artefacto y contrato, no la tesis, y un encargo explícitamente adversarial: encuentra lo que falla, presume que el autor está demasiado seguro, busca supuestos no declarados, casos límite no gestionados, acoplamientos ocultos, formas de violar el contrato, convenciones existentes que se rompen, formas de fallar con entradas inesperadas. No confirmes, no resumas: encuentra problemas, o declara que no has encontrado ninguno tras un examen cuidadoso. Una pregunta como «¿está bien?» produce un sí.

4. La reconciliación. Cada hallazgo se clasifica respecto al texto del artefacto: accionable (se corrige), ya cubierto (se indica dónde), no pertinente (se explica). No se toma la salida del revisor como verdad: se relee contra el artefacto.

5. La parada. El ciclo es limitado, no recursivo. Se para cuando los hallazgos se vuelven triviales, tras tres ciclos, o cuando decide el usuario. Pasados tres ciclos sin resultado, se lleva la cuestión al usuario.

Cuándo conviene

Cuando la corrección pesa más que la rapidez, cuando se trabaja en código que no se conoce, cuando lo que está en juego es alto (producción, lógica de seguridad, operaciones irreversibles) o cuando la decisión ha sido validada solo por quien la tomó.

Cuándo no hace falta

Para renombrar una variable o reformatear. El método tiene un coste, y para un cambio de una línea es desproporcionado.

Señales de alarma

  • Poner en marcha un revisor para un cambio trivial.
  • Tratar la salida del revisor como autoridad sin releer el artefacto.
  • Hacer más de tres ciclos sin implicar al usuario.
  • Preguntar «¿está bien?» en lugar de «encuentra los problemas».
  • Saltarse la duda por la presión del tiempo en una decisión de alto riesgo.
  • Relanzar al revisor sobre un artefacto sin cambios: mismos hallazgos, solo se está ganando tiempo.
  • Teatro de la duda: en dos o más ciclos con hallazgos sustanciales, ninguno se ha clasificado como accionable. Se está validando la tesis en lugar de ponerla a prueba.

Un ejemplo

Una tesis: «la migración puede volver a ejecutarse sin efectos secundarios». Se extraen el script y la regla de idempotencia. El revisor, que no conoce la tesis, observa que el script inserta una fila de registro antes de comprobar si la migración ya se ha aplicado: al volver a ejecutarse, duplica los registros y, peor, pone a cero un contador. El defecto no lo veía quien había escrito el script, convencido de su idempotencia.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

doubt-driven-developmentMétodo de cinco pasos para someter una decisión importante a un revisor adversarial con contexto nuevo: tesis, extracción del artefacto y del contrato, duda, reconciliación de los hallazgos, parada. Úsese cuando la corrección importa más que la rapidez o lo que está en juego es alto (producción, seguridad, operaciones irreversibles).