Saltar al contenido
MaestrIA

Formación › Programar con Claude Code en 12 horas › Hora 6

Programar con Claude Code en 12 horas · hora 6 de 12

Desarrollo guiado por especificaciones

Con un agente que programa rápido, el cuello de botella pasa a ser decir bien qué quieres. Una especificación escrita antes del código lo resuelve, pero no siempre compensa. Verás la spec real que escribió Claude Code para quitar duplicados y cuándo merece la pena el método.

Al terminar sabrásPedir una especificación con comportamiento esperado, casos límite, fuera de alcance y verificación final antes de programar, y decidir cuándo el desarrollo guiado por especificaciones es excesivo.

60 minutos· 1 esquema· 6 preguntas· 2 ejercicios· entregable

Repaso

Comprueba De la hora 5: Claude escribe una prueba para el duplicado de P-106 y pasa a la primera, antes de tocar el código. ¿Qué te dice?

Comprueba De la hora 4: al planificar el CSV, Claude ve que una fecha del repositorio está mal. ¿Qué debería hacer?

Comprueba De la hora 3: tu equipo exige que nadie edite datos/. ¿Dónde lo pones para que se cumpla?

Vocabulario

Spec (especificación)
El documento que dice qué debe hacer un cambio y cómo se comprueba, antes del código.
Caso límite
Una situación poco habitual que el diseño debe resolver, como dos filas con el mismo id y datos distintos.
Fuera de alcance
Lo que el cambio no va a tocar, escrito para que nadie lo amplíe por su cuenta.
Verificación de extremo a extremo
La comprobación final que demuestra que el cambio funciona completo.

El ejemplo: la spec de la deduplicación

Cada sesión grabada parte del repositorio de práctica recién descargado. Si arreglaste la medianoche en la hora 5, tus números serán distintos: para repetir esta sesión tal cual, descomprime el zip otra vez en una carpeta nueva.

Antes y después Una spec antes del código

Qué es el desarrollo guiado por especificaciones

La idea es sencilla: la especificación va delante del código. Primero se escribe qué debe pasar y cómo se comprueba; después, el agente programa contra esa especificación; al final, una verificación demuestra que se cumple.

El ciclo del desarrollo guiado por especificacionesPrimero se escribe la especificación, después el plan y las tareas, luego el código y las pruebas que lo demuestran; lo aprendido vuelve a la especificación.Especificaciónqué y por quéPlancómoTareaspasos pequeñosCódigoel agente escribePruebaslo demuestranlo aprendido actualiza la especificación
El ciclo: la especificación va delante y lo aprendido vuelve a ella.

La guía de buenas prácticas de Claude Code propone una variante muy práctica: dejar que Claude te entreviste («entrevístame con detalle sobre técnica, interfaz, casos límite y riesgos; después escribe SPEC.md») y ejecutar la spec en una sesión nueva, con el contexto limpio y centrado en implementarla. Según la guía, las specs más útiles nombran los ficheros e interfaces, dicen qué queda fuera de alcance y terminan con una verificación de extremo a extremo.

Cuándo compensa (y cuándo no)

Birgitta Böckeler, de Thoughtworks, analizó las herramientas de SDD (Kiro, spec-kit y Tessl) y distingue tres niveles: escribir la spec antes del código, mantenerla después como referencia, o tratarla como la fuente de la que sale el código. También recoge sus problemas: demasiado proceso para cambios pequeños, muchos ficheros que revisar y agentes que a veces ignoran lo que dice la spec.

La conclusión práctica:

  • Compensa: cambios con decisiones de diseño, varios ficheros, varias personas, o algo que habrá que mantener.
  • Sobra: una errata, un ajuste de una línea, un experimento que vas a tirar.

Practica

Clasifica ¿Spec primero o directamente?

  1. La deduplicación de paradas, con una decisión sobre filas en conflicto
  2. Corregir una errata en el título del parte
  3. Una exportación del parte que usarán tres departamentos
  4. Probar si una idea de cálculo funciona, para tirarla después

Ordena Ordena el flujo con spec

  1. Revisar la spec y decidir lo que deja abierto
  2. Ejecutar la verificación de extremo a extremo
  3. Pedir a Claude que te entreviste sobre el cambio
  4. Que escriba SPEC.md con alcance, casos límite y verificación final
  5. Abrir una sesión nueva e implementar contra la spec

Comprueba lo que has aprendido

Comprueba La spec real dejó «decisión a confirmar» sobre las filas en conflicto. ¿Por qué es lo correcto?

Comprueba ¿Para qué sirve el apartado «fuera de alcance»?

Comprueba ¿Cuándo es excesivo el desarrollo guiado por especificaciones?

Entregable Tu primera spec

Elige un cambio con alguna decisión de diseño en el repositorio de práctica o en tu proyecto. Pide a Claude que te entreviste y escriba SPEC.md con comportamiento esperado, casos límite, fuera de alcance y verificación final. Pega aquí la spec, las decisiones que tomaste tú y el resultado de la verificación tras implementarla.

Está bien si: la spec tiene al menos tres casos límite, un apartado de fuera de alcance y una verificación que se puede ejecutar; marcas qué decidiste tú; y la verificación pasó tras implementar. Tiempo: unos 40 minutos; si no te da, entrega solo la spec revisada.

Lo esencial

  • La especificación va delante: qué debe pasar y cómo se comprueba, antes del código.
  • Una buena spec marca lo que queda por decidir, en vez de decidir por ti.
  • Casos límite, fuera de alcance y verificación final son lo que más valor aporta.
  • Compensa en cambios con decisiones o que habrá que mantener; sobra en lo trivial.

Fuentes y para seguir

Lección revisada el 24/10/2026 con la documentación oficial enlazada en sus fuentes. Revisamos los cursos cada trimestre.