Communitygithub.com

chirag127/skill-tdd

Desarrollo Guiado por Pruebas (TDD) con el ciclo Rojo-Verde-Refactoriza. SIN CÓDIGO DE PRODUCCIÓN SIN UNA PRUEBA FALLIDA PRIMERO. Bloquea el engaño de la IA (escribir pruebas DESPUÉS de la implementación). Úsalo al implementar cualquier característica o corregir errores.

¿Qué es skill-tdd?

Esta skill aplica el Desarrollo Guiado por Pruebas (TDD) con la regla de hierro de 'No hay código de producción sin una prueba fallida primero'. Está diseñada para agentes de IA como Claude Code, Cursor o Codex, y bloquea activamente el engaño común de las IA que consiste en escribir pruebas después de la implementación. La skill impone un ciclo estricto de tres pasos: Rojo (escribir una prueba que falle), Verde (escribir el código mínimo para que pase) y Refactorizar (mejorar el código sin añadir comportamiento). Incluye mecanismos anti-trampa que obligan al agente a ver la salida de una prueba fallida antes de tocar código de producción, prohíben escribir múltiples pruebas antes de que la primera pase, y evitan reescribir pruebas para que coincidan con la implementación. También define el concepto de 'seams' (puntos de intersección públicos) que deben ser acordados con el usuario antes de escribir cualquier prueba, asegurando que las pruebas se mantengan estables frente a cambios internos. La skill referencia varios documentos de conocimiento para reforzar la retroalimentación rápida y la modularidad profunda.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

PasoAcciónDebe verificar
ROJOUNA 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.
VERDEMí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.
REFACTORIZARExtraer 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.
BUCLESiguiente 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

Skills relacionados