tdd — Rojo-Verde-Refactoriza
La Ley de Hierro
NO HAY CÓDIGO DE PRODUCCIÓN SIN UNA PRUEBA FALLIDA PRIMERO.
¿Escribiste código antes de la prueba? Bórralo. Empieza de nuevo. Sin excepciones — no lo guardes como "referencia", no lo "adaptes" mientras escribes pruebas, no lo mires. Implementa desde cero a partir de las pruebas.
Violar la letra de las reglas es violar el espíritu.
Disparador
Actívalo con: "TDD this" · "red-green-refactor" · "test-first" · nueva característica · corrección de errores · refactorización · cambio de comportamiento. En modo AFK, tarea según [[afk-vs-hitl-tasks]] con infraestructura de pruebas presente, dispáralo en silencio.
Excepciones (pregunta primero): prototipos desechables, código generado, archivos de configuración.
¿Estás pensando "saltar TDD solo esta vez"? Para. Eso es racionalización — consulta references/rationalizations.md si dudas.
Precondición
Bucle de pruebas <60s según [[feedback-loops-are-the-ceiling]]. Bucle lento → arregla el bucle PRIMERO, nunca te saltes TDD para esquivar pruebas lentas.
Lee CONTEXT.md + los ADR del área primero: los nombres de las pruebas y el vocabulario de la interfaz deben coincidir con el lenguaje del dominio del proyecto. (Paso de vocabulario de dominio de Matt Pocock 2026-07-08.)
Seams — acordar primero
Seam = límite público donde observas el comportamiento, sin acceder al interior. Las pruebas viven en los seams, nunca contra elementos internos. El código cambia; las pruebas ancladas a seams sobreviven.
Confirma los seams con el usuario antes de escribir cualquier prueba. No se escribe ninguna prueba sobre un seam no confirmado. El esfuerzo recae en caminos críticos + lógica compleja, no en cada caso límite. Pregunta: "¿Qué seams deberíamos probar?" (Marco de seams de Matt Pocock 2026-07-08.)
El ciclo — orden estricto
| Paso | Acción | Debe verificar |
|---|---|---|
| ROJO | UNA prueba fallida en un seam acordado. El comportamiento observable más pequeño. Código real, sin mocks a menos que sea inevitable. Nombre claro, sin "y". | La prueba FALLA con el error esperado. ¿Pasó inmediatamente? Estás probando comportamiento existente — corrige la prueba. ¿Errores? Corrige el error, vuelve a ejecutar hasta que falle correctamente. |
| VERDE | Mínimo código para que pase. Sin opciones YAGNI. Sin manejo de errores no probado. | La prueba PASA. Las demás pruebas siguen pasando. La salida está impecable. ¿Falla? Corrige el código, nunca la prueba. |
| REFACTORIZAR | Extraer módulos profundos según [[deep-modules-over-shallow]]. Renombrar para mayor claridad. Nunca añadir comportamiento en la refactorización. | Se mantiene en verde. |
| BUCLE | Siguiente prueba fallida. Corte vertical — una prueba → una implementación → repetir, cada una es una bala trazadora que responde a lo que enseñó el ciclo anterior. Vuelve a ROJO. | — |
Anti-patrones — bloqueados
- Acoplado a la implementación — simula colaboradores internos, prueba métodos privados, afirma a través de canales secundarios (consulta de BD vs interfaz). Señal: se rompe en refactorización cuando el comportamiento no cambia.
- Tautológico — la aserción recalcula el valor esperado de la misma manera que el código (
expect(add(a,b)).toBe(a+b), snapshot derivado a mano, constante-igual-a-sí-misma). Pasa por construcción. Los valores esperados deben venir de fuente independiente: literal conocido, ejemplo resuelto, especificación. (Marco tautológico de Matt Pocock 2026-07-08.) - Corte horizontal — todas las pruebas primero, luego toda la implementación. Verifica comportamiento imaginado; las pruebas se vuelven insensibles a cambios reales. Trabaja solo en cortes verticales. (Marco vertical vs horizontal de Matt Pocock 2026-07-08.)
Anti-trampa — bloqueados
- DEBE ver la salida de la prueba fallida antes de escribir código de producción.
- DEBE NO escribir múltiples pruebas antes de que la primera pase.
- DEBE NO saltarse la refactorización.
- DEBE NO reescribir la prueba para que coincida con la implementación después del hecho.
Prueba escrita DESPUÉS del código = con forma de código, no con forma de especificación. Invalida el propósito.
Forma de salida por ciclo
SEAM: <interfaz pública bajo prueba>
RED: <nombre de la prueba> → <mensaje de fallo esperado>
GREEN: <archivos cambiados, delta LOC>
REFACTOR: <qué se extrajo/renombró>
Referencias cruzadas
- feedback-loops-are-the-ceiling
- deep-modules-over-shallow
- afk-vs-hitl-tasks
references/rationalizations.md— cada contraataque de "TDD es dogmático" + la réplica- Fuente: Kent Beck 1999 · obra/superpowers test-driven-development fusionado 2026-07-04 · Matt Pocock 2026-07-04 (lista de verificación de skills) + 2026-07-08 (seams, tautológico, corte vertical, CONTEXT.md)