Desarrollo Guiado por Pruebas (TDD)
TDD es el bucle rojo → verde → refactorización. Esta habilidad es la referencia que hace que ese bucle produzca pruebas que valgan la pena: qué es una buena prueba, dónde van las pruebas, los antipatrones y las reglas del bucle. Cada sección se aplica en cada ciclo; consúltelas antes y durante el bucle, no después.
Al explorar el código base, lea CONTEXT.md (si existe) para que los nombres de las pruebas y el vocabulario de las interfaces coincidan con el lenguaje del dominio del proyecto, y respete los ADR en el área que está tocando.
Qué es una buena prueba
Las pruebas verifican el comportamiento a través de interfaces públicas, no detalles de implementación. El código puede cambiar por completo; las pruebas no deberían. Una buena prueba se lee como una especificación — "el usuario puede finalizar la compra con un carrito válido" te dice exactamente qué capacidad existe — y sobrevive a las refactorizaciones porque no le importa la estructura interna.
Vea tests.md para ejemplos y mocking.md para pautas de simulación.
Costuras — dónde van las pruebas
Una costura es el lugar donde el módulo bajo prueba presenta su interfaz: donde observas el comportamiento sin entrar en su interior. Las pruebas residen en las costuras, nunca contra los componentes internos.
Antes de escribir una prueba, identifica la costura bajo prueba. Si una interfaz pública existente es la costura obvia, indícala y procede. Si la costura es nueva o ambigua, confírmala primero con el usuario. No puedes probarlo todo — elegir las costuras deliberadamente es cómo el esfuerzo de prueba se concentra en las rutas críticas y la lógica compleja en lugar de en cada caso extremo.
Pregunta: "¿Cuál es la interfaz pública, y qué costuras deberíamos probar?"
Antipatrones
- Acoplado a la implementación — simula colaboradores internos, prueba métodos privados o verifica a través de un canal secundario (consultando la base de datos en lugar de usar la interfaz). La señal: la prueba se rompe cuando refactorizas pero el comportamiento no ha cambiado.
- Tautológico — la aserción recalcula el valor esperado de la misma manera que el código (
expect(add(a, b)).toBe(a + b), una instantánea derivada manualmente de la misma manera, una constante afirmada igual a sí misma), por lo que pasa por construcción y nunca puede diferir del código. Los valores esperados deben provenir de una fuente independiente de verdad — un literal conocido como bueno, un ejemplo resuelto, la especificación. - División horizontal — escribir todas las pruebas primero, luego toda la implementación. Las pruebas masivas verifican un comportamiento imaginado: pruebas la forma de las cosas en lugar del comportamiento orientado al usuario, las pruebas se vuelven insensibles a cambios reales y te comprometes con la estructura de las pruebas antes de entender la implementación. Trabaja en porciones verticales en su lugar — una prueba → una implementación → repetir, cada prueba es una bala trazadora que responde a lo que el último ciclo te enseñó.
Reglas del bucle
- Rojo antes que verde. Escribe la prueba fallida primero, luego solo el código suficiente para pasarla. No anticipes pruebas futuras ni añadas características especulativas.
- Una porción a la vez. Una costura, una prueba, una implementación mínima por ciclo.
- Refactoriza después del verde. Mejora nombres y estructura manteniendo el comportamiento sin cambios y las pruebas pasando. No añadas nuevo comportamiento durante la refactorización; los cambios arquitectónicos más amplios pertenecen a la etapa de revisión (consulta la habilidad
code-review).