Desarrollo guiado por pruebas con agentes de IA

¿Qué es TDD (Desarrollo Guiado por Pruebas)?

En esencia, TDD gira en torno a un proceso cíclico conocido como Rojo-Verde-Refactorizar. El ciclo comienza con la fase “Rojo”, donde el desarrollador escribe un caso de prueba automatizado que define una funcionalidad o comportamiento deseado. Esta prueba se escribe intencionalmente para fallar al principio porque el código correspondiente aún no existe. Este fallo inicial es fundamental ya que garantiza que la prueba realmente evalúa la funcionalidad deseada y podrá detectar errores una vez que se implemente el código.

La fase “Verde” consiste en escribir la mínima cantidad de código necesaria para que la prueba previamente fallida pase. Este principio anima a los desarrolladores a enfocarse en el requerimiento inmediato definido por la prueba, mantener una base de código limpia y evitar la sobreingeniería.

Finalmente, la fase “Refactorizar” se centra en mejorar la estructura, legibilidad y mantenibilidad tanto del código de pruebas como del código de producción, asegurando que todas las pruebas existentes sigan pasando. La refactorización garantiza que la base de código se mantenga sana y adaptable a cambios futuros sin introducir regresiones, con la suite de pruebas existente como red de seguridad durante esta fase.

¿Cómo automatizar completamente tu pipeline de TDD?

Hay muchos factores que afectan el rendimiento de los agentes de IA a la hora de programar. Desde el modelo LLM hasta cómo estructuras tu código y tu pipeline de desarrollo. Hemos comprobado que TDD es efectivo con Windsurf y Claude 3.5 sonnet. A continuación, se muestra una tarea de ejemplo implementada con TDD.

¿Qué necesitas?

Antes de comenzar a programar, necesitamos lo siguiente:

Pruebas suficientes

Asegúrate de que ya tienes pruebas según TDD y que cubren la mayor parte del alcance de tu problema que consideras lógico y útil para el agente de IA. No necesitas cambiar ni personalizar nada solo por el agente de IA. Si tus pruebas y su convención de nombres siguen un estándar, mucho mejor. Como primer paso, el agente de IA verá estas pruebas para comenzar la implementación.

Aquí tienes un ejemplo de una prueba que verifica si un documento ha sido insertado correctamente en MongoDB:

Interfaces

Una interfaz en Java (o cualquier otro lenguaje de programación) es una estructura que define cómo deben lucir las clases y qué métodos deben implementar. Para guiar aún más al agente de IA, sería útil crear una interfaz para tu repositorio de inserción de documentos:

Descripción específica de la tarea

Por último, necesitamos una descripción específica de la tarea. Normalmente, puedes usar JIRA o issues de GitHub donde defines la tarea. Esta es la nuestra:

Comienza con Vibe Coding

Vibe coding significa que describes lo que necesitas en lenguaje natural (o incluso con comandos de voz), y la IA genera el código en tiempo real. Profundizamos en Vibe Coding en este blog. Aquí está el prompt que usé en Windsurf para completar la tarea por mí:

Implementa la siguiente consulta como una combinación de una o más consultas nombradas y código Java.

Encuentra todos los conductores que hayan completado al menos X viajes con una calificación superior a 5 en un rango de fechas dado y que nunca hayan recibido una calificación inferior a 3 estrellas.

Nota:
No necesitas encontrar una sola consulta que resuelva esta tarea (puedes usar una combinación de código Java y consultas nombradas), pero debes tener en cuenta el rendimiento del ORM, es decir, asegúrate de que tu solución también sea razonablemente rápida si tienes muchas entidades. Durante la sesión de discusión deberías poder explicar qué tipos de problemas pueden surgir con consultas mal escritas.

@Ass1_2_2Test.java#L35-60 estas son las pruebas correspondientes. Está implementado en @DriverDAO.java#L34-63

Mencionar los archivos es el aspecto más importante al hacer vibe coding. Ahora siéntate y observa cómo el agente de IA hace su magia. Implementó la clase, ejecutó las pruebas y reiteró hasta que todas pasaron: