Desarrollo guiado por pruebas: rojo, verde, refactorización y la prueba de los errores

El ciclo del TDD, el modelo de prueba para los errores, la pirámide de pruebas, cómo escribir pruebas que describan comportamientos y los antipatrones más comunes.

MetodologíametodologiatestTDDingegneria del software19 de noviembre de 2026 · actualizado el 19 de noviembre de 2026 · 3 min de lectura

«Todas las pruebas pasan» es una frase que solo vale si las pruebas dicen algo. El desarrollo guiado por pruebas (TDD) nace por eso: una prueba que nunca ha fallado nunca ha demostrado que puede fallar, y por tanto no demuestra nada cuando pasa.

El ciclo

Rojo. Se escribe una prueba para el comportamiento deseado y se ejecuta: debe fallar, por el motivo correcto. Una prueba que pasa a la primera podría no probar lo que se cree.

Verde. Se escribe el código mínimo que la hace pasar, nada más.

Refactorización. Con las pruebas en verde se mejora la estructura (nombres, duplicaciones, claridad) sin cambiar el comportamiento. Si una prueba se rompe, el cambio ha alterado algo que no debía.

La prueba para los errores

Cuando llega un informe de error no se empieza por el código: se empieza por una prueba que reproduzca el error y falle. Solo entonces se corrige. Al final la prueba pasa y queda como protección: el mismo error no volverá en silencio. Una corrección sin prueba de reproducción es una opinión.

La pirámide de pruebas

Muchas pruebas pequeñas y rápidas (unitarias), menos pruebas de integración, poquísimas pruebas completas de extremo a extremo. Se eligen según el recurso que consumen: las pruebas que no tocan red ni base de datos son rápidas y se ejecutan de continuo; las que implican servicios externos son lentas y deben reservarse para lo que no se puede probar de otro modo.

Escribir buenas pruebas

  • Verificar el estado, no las interacciones. Una prueba debería decir «tras la operación el resultado es X», no «se llamó a la función Y tres veces»: la segunda se rompe en cada refactorización.
  • Claridad antes que no repetición. En las pruebas conviene algo de repetición si hace cada prueba legible por sí sola.
  • Mejor las implementaciones reales que las falsas. Los sustitutos (mocks) sirven para fronteras costosas o no deterministas; usados en todas partes, las pruebas prueban los sustitutos, no el código.
  • Preparar, actuar, verificar. Tres bloques distintos en cada prueba.
  • Un concepto por prueba. Cuando falla, hay que entender enseguida qué.
  • Nombres descriptivos. «rechaza_la_reserva_si_la_sala_está_ocupada» dice más que «test_reserva_2».

Antipatrones

Pruebas que verifican el comportamiento del framework en lugar del de la aplicación; pruebas que dependen del orden de ejecución; pruebas saltadas para que pase la suite; pruebas con nombres que no describen nada.

Señales de alarma

  • Código escrito sin ninguna prueba correspondiente.
  • Pruebas que pasan a la primera.
  • «Todas las pruebas pasan» sin que ninguna prueba se haya ejecutado de verdad.
  • Correcciones de errores sin prueba de reproducción.
  • Pruebas desactivadas para volver a poner la suite en verde.

Un ejemplo

Un informe: «el total del pedido es erróneo con dos descuentos». Se escribe una prueba con un pedido y dos descuentos, que falla con el total equivocado. Se descubre que el segundo descuento se aplica sobre el precio original en lugar del reducido. Se corrige: la prueba pasa. Un mes después, alguien cambia el cálculo y la prueba falla antes de que el defecto llegue a producción.

Cuándo usarlo

Al implementar cualquier lógica, corregir un error o cambiar un comportamiento; cuando hay que demostrar que el código funciona; cuando se está a punto de modificar algo existente.

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.

test-driven-developmentMétodo para desarrollar guiados por pruebas: ciclo rojo-verde-refactorización, prueba de reproducción antes de corregir un error, pirámide de pruebas, reglas para pruebas legibles y antipatrones. Úsese al implementar lógica, corregir un error o cambiar un comportamiento existente.