Definition of Done para código de IA: evidencias en vez de promesas

Una Definition of Done es la lista de condiciones bajo las cuales una tarea se considera terminada. En el desarrollo asistido por IA necesita un añadido que antes era obvio: que alguien haya entendido el código. Y necesita evidencias en lugar de promesas: «probado» no es una finalización; la salida de la ejecución de las pruebas, sí.

¿Por qué el desarrollo asistido por IA necesita otra Definition of Done?

Porque el cuello de botella se ha desplazado. Antes, escribir era el paso caro y revisar el barato. Hoy es al revés: el código surge en minutos, y entenderlo lleva el mismo tiempo de siempre.

Una Definition of Done que no refleje este desplazamiento da por terminado un trabajo cuya parte más cara aún está pendiente. La Stack Overflow Developer Survey 2025 muestra dónde recae esa parte: el 45 % de los encuestados pierde mucho tiempo depurando código de IA, y el 66 % cita «casi correcto, pero no del todo» como mayor frustración.

¿Qué aspecto tiene una Definition of Done para código de IA?

Nueve puntos, separados según quién los verifica. La separación es el verdadero truco: lo que una máquina puede decidir no debe costarle tiempo a una persona.

Verificable automáticamente: pertenece al pipeline

• La ejecución de pruebas está en verde, sin pruebas omitidas.
• La cobertura de las líneas modificadas no es inferior al valor del proyecto.
• Ningún hallazgo nuevo del análisis estático por encima de la gravedad establecida.
• Ninguna dependencia nueva con vulnerabilidades críticas conocidas; licencias revisadas.
• Ninguna credencial ni secreto en el código fuente.

Verificable solo por personas: pertenece a la revisión

• Una persona con nombre y apellidos puede explicar el cambio sin preguntarle a la IA.
• El diff contiene solo lo que forma parte de la tarea, sin efectos secundarios imprevistos.
• Se han tenido en cuenta los permisos y los casos de error, no solo el camino feliz.
• No existe en el proyecto nada que haga ya lo mismo.

El último punto es el añadido más específico para el código de IA. Un modelo duplica lo que no conoce, y la tasa de duplicados aumenta en consecuencia desde hace años. Ninguna herramienta plantea esta pregunta por sí sola.

¿Cómo hago que «terminado» sea demostrable en lugar de afirmado?

Haciendo que el aviso de finalización incluya la evidencia y no la promesa. Es un cambio pequeño con gran efecto, porque descarta toda una clase de malentendidos.

• En lugar de «las pruebas pasan»: las últimas líneas de la salida de las pruebas con el número y el resultado.
• En lugar de «lo he revisado»: el comando y su salida.
• En lugar de «está desplegado»: el código de estado de la URL consultada.

El motivo no es la desconfianza. El motivo es que entre «lo he ejecutado» y «está en verde» hay un paso que, con las prisas, se omite, y la evidencia hace imposible omitirlo sin que nadie tenga que controlarlo.

¿Cómo introduzco una nueva Definition of Done sin que se ignore?

Empezando por la parte automática y añadiendo la humana después. Una lista que exige nueve puntos el primer día se convierte en una formalidad el tercero.

• Primero los cinco puntos automáticos en el pipeline. No le cuestan tiempo a nadie y no generan discusión: una máquina que aborta el proceso no se percibe como una tutela.
• Después dos puntos humanos, no cuatro. Como punto de partida se recomiendan: «alguien puede explicar el cambio» y «el diff contiene solo lo que forma parte de la tarea». Ambos pueden valorarse en segundos y detectan la mayor parte de los problemas.
• Añadir los dos restantes cuando los siete primeros estén asentados. Los permisos y la comprobación de duplicados requieren más atención y solo compensan cuando el resto ya no se discute.
• Mantener la lista visible. Como plantilla en la pull request, no como página en el wiki. Lo que no está en el flujo de trabajo no existe en el flujo de trabajo.

Una advertencia sobre las expectativas: las primeras semanas parecen más lentas. No es señal de que la lista sea demasiado estricta: es el trabajo que antes se posponía y que ahora se hace en su lugar.

¿Qué no debe formar parte de la Definition of Done?

Todo lo que no es verificable o no se da en cada tarea.

• «El código está limpio». Formulado de forma no verificable. Lo que se quiere decir está en el análisis estático y en la revisión.
• «Documentación actualizada». Solo si realmente se aplica a cada tarea; de lo contrario, el punto se marca por compromiso en una de cada dos tareas y pierde su significado.
• Puntos que nadie revisa. Un criterio que lleva un año cumpliéndose sin que nadie lo controle es decoración.

Preguntas frecuentes sobre la Definition of Done

¿En qué se diferencia la Definition of Done de un Quality Gate?

El gate es la parte aplicada automáticamente; la Definition of Done es el acuerdo completo, incluidos los puntos humanos. Lo ideal es que el gate haga cumplir exactamente los cinco puntos superiores; véase Qué es un Quality Gate.

¿Rige la misma definición para los prototipos?

No, y conviene dejarlo expresamente por escrito. Un prototipo tiene su propia definición, más corta. El error surge cuando un prototipo se considera después terminado sin una nueva revisión; véase Del prototipo a producción.

¿Cuántos puntos puede tener una Definition of Done?

Tantos como se comprueben realmente en cada tarea. Nueve está en el límite superior y solo funciona porque cinco de ellos se ejecutan automáticamente.

¿Quién decide si se cumple la definición?

Para la parte automática, el pipeline. Para la parte humana, la persona que hace la revisión, no la que presentó el cambio.

La diferencia entre «está hecho» y una evidencia decide si una Definition of Done se sostiene. Code Guardian cierra cada cambio con una auditoría cuyos hallazgos están acreditados mediante el comando: verificado en lugar de afirmado.

Fuentes

• Stack Overflow Developer Survey 2025, sección «AI» (45 % de pérdida de tiempo en depuración, 66 % «almost right»).
• GitClear, The Maintainability Gap: 2026 AI Code Quality Research.

Fecha: 27 de julio de 2026. Valoración técnica de carácter general.