Glosario de IA Strategy & Business
¿Qué es el desarrollo guiado por especificaciones (spec-driven development, SDD)?
Desarrollo guiado por especificaciones (Spec-Driven Development (SDD))
← Todos los términos del glosarioUna forma de construir software en la que primero se escribe una especificación explícita y revisable, y de ella salen el código, las pruebas y la documentación.
Explicación
El desarrollo guiado por especificaciones (spec-driven development, SDD) trata la especificación como fuente de verdad: requisitos, criterios de aceptación, contratos de API y esquemas de eventos se escriben y revisan antes que el código. Después, los equipos generan o escriben stubs, pruebas y documentación a partir de ella, y así se reduce la distancia entre lo acordado y lo construido. Con los agentes de código con IA la idea ha ganado peso, porque una especificación precisa le da al modelo un contrato acotado en lugar de una petición vaga. La especificación es un documento vivo que se actualiza cuando el equipo entiende mejor el problema, y el código la sigue.
Cómo funciona
Un flujo típico pasa por fases, y cada una se revisa antes de empezar la siguiente:
- Especificar: describir qué se construye y por qué, para quién y con qué criterios de aceptación.
- Planificar: convertir la especificación en un plan técnico con arquitectura, contratos y restricciones.
- Descomponer: dividir el plan en tareas pequeñas que se puedan probar.
- Implementar: escribir o generar el código de cada tarea y comprobarlo contra la especificación y sus pruebas.
Las partes de la especificación que lee una máquina, como un documento OpenAPI o un JSON Schema, sirven directamente para generar clientes, mocks y pruebas de contrato.
Por qué importa con agentes de código
Los agentes de IA escriben código deprisa, pero rellenan los huecos suponiendo. Un prompt corto deja muchas decisiones abiertas; una especificación revisada cierra la mayoría. Además, da a las personas algo concreto que revisar antes de que exista el código, y eso sale más barato que revisar cambios grandes después.
Herramientas como Spec Kit, el kit open source de GitHub, y otras construidas sobre la misma idea, ordenan este flujo para los agentes de código.
SDD, TDD y API-first
El desarrollo guiado por pruebas (TDD) escribe una prueba que falla antes de cada trozo de código; el desarrollo guiado por especificaciones empieza un nivel más arriba, con el comportamiento y los contratos de toda la funcionalidad. API-first es una forma de SDD centrada en las interfaces: el contrato de la API se acuerda antes de construir los servicios. En la práctica se combinan bien: la especificación define el comportamiento y los contratos, y las pruebas que salen de ella mantienen honesto al código.
Cuándo tiene sentido
- Varios equipos o agentes construyen piezas que tienen que encajar.
- Los requisitos necesitan el visto bueno de negocio, legal o un cliente antes de construir.
- Los agentes de IA generan buena parte del código.
- El sistema tiene interfaces públicas o de larga vida.
En experimentos pequeños o prototipos de usar y tirar, una especificación completa puede estorbar más que ayudar.
Preguntas frecuentes
¿Qué significa SDD en desarrollo de software?
SDD son las siglas de spec-driven development, desarrollo guiado por especificaciones: construir software a partir de una especificación explícita y revisada que guía la implementación. La fuente de verdad es la especificación, no el código.
¿Es lo mismo que el desarrollo en cascada?
No. La cascada fija una especificación enorme al principio y casi nunca la revisa. En el SDD la especificación es un artefacto vivo, pequeño por funcionalidad, que se actualiza a medida que el equipo aprende, y el código sale de ella en ciclos cortos.
¿Cómo ayuda el SDD a programar con IA?
Le da al agente de IA una descripción precisa y acotada de lo que tiene que construir, así que supone menos. Las personas revisan la especificación antes de que exista el código, y las pruebas derivadas de ella comprueban que el código generado hace lo acordado.
¿Qué es GitHub Spec Kit?
Spec Kit es un kit open source que GitHub publicó para probar el desarrollo guiado por especificaciones con agentes de código. Ordena el trabajo en fases: de la especificación a un plan técnico, tareas e implementación.
¿Qué lleva una buena especificación?
El objetivo y los usuarios, el comportamiento esperado con criterios de aceptación, las interfaces y contratos de datos, restricciones como seguridad y rendimiento, y lo que queda fuera de alcance. Debe ser lo bastante corta para revisarla y lo bastante precisa para probarla.
Guías de decisión que usan este término
Cómo llevarlo a la práctica
Dónde aparece en Thinkia
Para seguir leyendo
Términos relacionados
Fuentes
- GitHub Blog · Spec-driven development with AI: get started with a new open source toolkit (en inglés)
- OpenAPI Initiative · OpenAPI Specification v3.1.0 (en inglés)
- Kiro · Feature specs (requirements, design and tasks) (en inglés)
Actualizado: 2026-10-21