Saltar a contenido

Spec-Driven Development

Una guía para equipos técnicos que ya saben usar agentes de codificación (Claude Code, Codex, Cursor, Copilot…) y han chocado con el muro: los resultados son inconsistentes, el agente se desvía a media sesión, los refactors rompen archivos que el agente nunca vio, y "escribe un mejor prompt" dejó de funcionar hace tiempo.

Es la segunda guía de una trilogía: viene después de la guía de fundamentos (qué es un agente, cómo se usa) y antes de la guía de harness engineering (cómo se implementa el sistema alrededor del agente). El SDD es la disciplina intermedia: cómo estructurar el trabajo para que el agente pueda ejecutarlo bien.

Premisas

  • Sabes pilotar un agente y has visto sus límites en proyectos reales.
  • No buscas un producto mágico, buscas una disciplina.
  • Estás dispuesto a pagar el coste de escribir specs si eso evita el coste mayor de retrabajo, drift y deuda invisible.
  • Quieres criterio, no dogma: te interesa saber cuándo SDD ayuda y cuándo es burocracia.

Tesis central

El cuello de botella ya no es escribir código. Es especificar la intención con la suficiente claridad como para que un agente la pueda ejecutar — y mantener esa especificación viva mientras el código evoluciona.

Cómo leer esta guía

Los capítulos están ordenados de problema → fundamentos → ciclo → práctica → puente, pero cada uno se sostiene por sí solo. Si ya tienes claro el "por qué", salta al capítulo que te resuelva un problema concreto. Si vienes de cero, léelos en orden.

Hay dos capítulos que no son opcionales aunque parezcan negativos: el 9 (la crítica honesta) y el 10 (code-embedded context como complemento). Sin ellos, el curso es marketing. Con ellos, da criterio.

Índice

Capítulo 0 — Puerta de entrada

Parte 1 — El problema

Parte 2 — Fundamentos

Parte 3 — Ciclo de vida

Parte 4 — Puesta en práctica

Parte 5 — Qué sigue

Qué no encontrarás en esta versión

  • Comparativas exhaustivas de herramientas. El ecosistema cambia cada trimestre; el capítulo 7 es un mapa, no una guía de compra.
  • Plantillas de spec listas para producción. Hay esqueletos en los capítulos 3 y 9, pero la spec útil se escribe contra tu dominio, no contra una plantilla genérica.
  • Promesas de productividad. Si alguien te promete 10×, probablemente no ha leído el capítulo 9.

Fuentes

Esta guía sintetiza ideas de: