Módulo 4: TDD Workflow Completo

Módulo 4: TDD Workflow Completo con Claude Code

Siguiente →

Módulo 4: TDD Workflow Completo con Claude Code

Descripción de la cápsula

Phase 1 te dio las piezas: spec-first para pensar en tests primero, unit tests para verificar lógica aislada, integration y E2E tests para verificar componentes y flujos. Tienes las técnicas. Lo que aún no tienes es el proceso completo.

Este módulo ensambla todo en un workflow iterativo: red-green-refactor con Claude Code. Escribes un test que falla (rojo) → Claude Code implementa el código (verde) → refactorizas con la seguridad de que los tests pasan. Repites. Cada feature se construye ciclo por ciclo, test por test, de forma incremental.

Pero hay algo que hace al TDD con AI fundamentalmente diferente del TDD clásico: la implementación llega en segundos. El bottleneck ya no es escribir código — es la calidad de tus tests y tu juicio para decidir cuándo intervenir. Cuando Claude Code falla un test, ¿el problema es la implementación (deja que itere) o la spec (ajusta el test)? Ese juicio es el skill real de este módulo.

Contexto del Módulo

¿Dónde estamos?

Este es el Módulo 4 — primero de Phase 2 (Workflows de Testing).

Lo que ya sabes (Phase 1):

  • ✅ Spec-first methodology y TDD con AI (Módulo 1)
  • ✅ Generar y evaluar unit tests con Claude Code (Módulo 2)
  • ✅ Integration tests, E2E tests, test pyramid (Módulo 3)

Lo que falta: El proceso iterativo completo. Pasar de "sé escribir tests" a "sé construir features completas con TDD y AI."

¿Hacia dónde vamos?

Phase 1: Fundamentos TDD con AI ✅
├── Módulo 1: ✅ Spec-first
├── Módulo 2: ✅ Unit tests
└── Módulo 3: ✅ Test pyramid

Phase 2: Workflows de Testing
├── Módulo 4: ← ESTÁS AQUÍ — TDD workflow completo
├── Módulo 5: → Coverage y edge cases
└── Módulo 6: → Mocking, fixtures, validation loops

Phase 3: Proyecto Final
├── Módulo 7: → Estrategia de testing profesional
└── Módulo 8: → Proyecto integrador

Phase 2 toma las piezas de Phase 1 y las convierte en workflows productivos. Este módulo es el puente — transforma técnicas dispersas en un proceso repetible.

Objetivo Profesional

Dominar el ciclo TDD completo con Claude Code: red → green → refactor, con el juicio para decidir cuándo intervenir y cuándo dejar que Claude Code itere.

Al final de este módulo podrás:

  • ✅ Ejecutar el ciclo TDD completo: test rojo → Claude Code implementa → validar → refactorizar
  • ✅ Dar contexto adecuado a Claude Code (test + interfaces + constraints)
  • ✅ Decidir cuándo intervenir vs dejar que Claude Code itere
  • ✅ Aplicar spec refinement: ajustar tests cuando descubres que la spec estaba incompleta
  • ✅ Construir una feature completa con múltiples ciclos TDD consecutivos
  • ✅ Mantener el ritmo: tests pequeños e incrementales, ciclos de minutos

Progresión del Módulo

Mapa del Módulo

CápsulaTemaQué aprenderás
02Red-Green-Refactor con AIEl ciclo TDD adaptado para AI: diferencias con TDD clásico, el ritmo agentic, el rol del developer
03Writing failing tests firstCómo escribir tests rojos efectivos: tests pequeños, incrementales, un propósito por test
04Claude Code implement cycleEl ciclo de implementación: dar contexto, evaluar resultado, iterar, cuándo intervenir
05Refactoring con tests como safety netRefactorizar sin miedo usando tests verdes como red de seguridad
06Proyecto: Feature completa con TDDConstruir un sistema de autenticación completo con múltiples ciclos TDD

Flujo de aprendizaje

Primero entenderás el ciclo adaptado (cápsula 02): cómo red-green-refactor cambia cuando Claude Code es tu implementador. El ritmo es diferente, el bottleneck es diferente, y el skill del developer es diferente.

Luego dominarás el input del ciclo (cápsula 03): escribir tests rojos que sean claros, pequeños, y que le den a Claude Code suficiente información para implementar correctamente.

Después aprenderás la interacción con Claude Code (cápsula 04): cómo dar contexto, qué hacer cuando falla, cuándo ajustar tu prompt vs tu test, y el framework para decidir cuándo intervenir.

La cápsula 05 cierra el ciclo con refactoring: usar los tests verdes como safety net para mejorar el código sin romper funcionalidad.

El proyecto (cápsula 06) integra todo: construir un sistema de autenticación completo con múltiples ciclos TDD, experimentando spec refinement, errores de Claude Code, y el ritmo real del workflow.

Conexión con Proyecto

Proyecto de este módulo: Feature completa con TDD

Construirás un sistema de autenticación (registro, login, tokens) usando TDD con Claude Code. Cada aspecto empieza como un test:

Ciclo 1: test_register_validates_email → Claude implementa validación
Ciclo 2: test_register_hashes_password → Claude implementa hashing
Ciclo 3: test_register_creates_user → Claude implementa registro
Ciclo 4: test_login_returns_token → Claude implementa login
Ciclo 5: test_token_validates_correctly → Claude implementa validación
...

La clave no es el código final — es experimentar el proceso: múltiples ciclos, spec refinement cuando descubres que algo falta, y el juicio de cuándo intervenir.

Conexión con proyecto final (Módulo 8)

En el proyecto final, cada feature de la aplicación se construye exactamente así. La diferencia es la escala: aquí es una feature, en Módulo 8 es una aplicación completa. Si dominas el ritmo aquí, el proyecto final es simplemente "más ciclos."

Límites: Qué NO Se Hará en Este Módulo

  • ❌ Coverage metrics — Se mide en Módulo 5. Aquí el foco es el proceso, no los números
  • ❌ Mocking de servicios externos — Se cubre en Módulo 6. Aquí trabajamos con lógica real
  • ❌ CI/CD integration — No es parte del scope de esta guía
  • ❌ Testing de performance — El foco es funcionalidad, no rendimiento
  • ❌ Debugging profundo de Claude Code — Cubrimos cuándo intervenir, no cómo debuggear el modelo

Evidencia de Éxito

Al terminar este módulo, sabrás que tuviste éxito si:

  • ✅ Puedes describir tu proceso TDD con AI paso a paso
  • ✅ Puedes construir una feature empezando desde un test rojo
  • ✅ Sabes cuándo el problema es tu test vs la implementación de Claude Code
  • ✅ Puedes refactorizar código con confianza porque tus tests lo respaldan
  • ✅ Completaste el proyecto: sistema de autenticación construido ciclo por ciclo con TDD

Resumen

  • ✅ Este módulo transforma técnicas aisladas en un workflow productivo
  • ✅ El ciclo TDD con AI: test rojo → Claude Code implementa → validar → refactorizar
  • ✅ El skill diferenciador: saber cuándo intervenir vs dejar iterar
  • ✅ Tests pequeños e incrementales — cada ciclo debe tomar minutos
  • ✅ Spec refinement: los tests evolucionan a medida que entiendes mejor el problema
  • ✅ El proyecto construye una feature real con múltiples ciclos TDD consecutivos

Próxima cápsula: Red-Green-Refactor con AI — el ciclo TDD adaptado para trabajar con Claude Code.

Recursos Adicionales

  1. Kent Beck: Test-Driven Development by Example - El libro original de TDD
  2. Martin Fowler: Refactoring - Técnicas de refactoring con tests
  3. Anthropic: Claude Code Docs - Documentación oficial de Claude Code
  4. pytest Documentation - Referencia completa de pytest
  5. The Pragmatic Programmer: Red-Green-Refactor - Contexto y filosofía del ciclo TDD

Módulo 4 — Testing with Claude Code Guide De técnicas aisladas a un workflow productivo

← AnteriorProyecto del Módulo: Test Pyramid CompletaSiguiente →Red-Green-Refactor con AI