> La metodología que transforma especificaciones en código de calidad con IA

---

🚀 Resumen

SDD: La especificación es la fuente de verdad. El código se deriva de ella.

• ✅ Define QUÉ y POR QUÉ antes de CÓMO
• ✅ Compatible con agentes de IA
• ✅ 4 fases: Specify → Plan → Tasks → Implement
• ✅ 3 niveles: Spec-First → Spec-Anchored → Spec-as-Source

---

📚 ¿Qué es una Spec?

Artefacto estructurado que describe QUÉ debe hacer el software y POR QUÉ.

---

🎯 3 Niveles de Madurez

> 💡 Recomendación: Comienza con Spec-First y evoluciona gradualmente.

---

🔄 Las 4 Fases

Specify → Plan → Tasks → Implement
  QUÉ+POR QUÉ → CÓMO → Unidades → Código+Tests

1. Specify: Captura intención, criterios de éxito, límites
2. Plan: Decide tecnologías, arquitectura, dependencias
3. Tasks: Descompón en unidades atómicas ejecutables
4. Implement: Agente IA genera código; humano valida contra spec

---

📝 Anatomía de una Spec

markdown# Título + resumen (1-2 oraciones)

## Contexto y motivación
¿Por qué se necesita? ¿Qué problema resuelve?

## Criterios de éxito
- Métricas cuantificables

## Requisitos funcionales
- Comportamientos esperados

## Restricciones
- Stack, APIs, patrones del proyecto

## Fuera de alcance ⚠️
- Qué NO construir

## Criterios de aceptación
- Given/When/Then verificables

Principios clave

• Separar QUÉ de CÓMO
• Ser precisa sin ser excesiva
• Incluir siempre "fuera de alcance"
• Si >2 páginas, descomponer la feature

---

🤖 SDD con Agentes IA

5 Principios

1. Diseñar antes de implementar (no codificar sin spec revisada)
2. Modelo capaz para spec/plan; modelo rápido para implementación
3. Revisión humana entre cada fase
4. Mantener spec dentro del contexto del agente
5. Tests como guardrails automáticos

Flujo multi-agente

> ⚠️ Usa agentes diferentes para código y tests.

---

✅ ¿Cuándo usar SDD?

Usar cuando:

• Proyecto nuevo + IA genera código
• Múltiples equipos trabajan en paralelo
• Requisitos de compliance/regulatorios
• Modernización de legado
• Funcionalidad compleja con múltiples stakeholders

Evitar cuando:

• Prototipo descartable
• Bugfix trivial
• Cambio pequeño por desarrollador con contexto completo

Guía rápida

---

⚠️ Antipatrones Comunes

---

🛠️ Buenas Prácticas

Sobre la Spec

• Empezar por una feature, no todo el sistema
• Spec más corta que sea completa (<2 páginas)
• Versionar specs junto al código (specs/)
• Usar lenguaje de dominio, no jerga técnica

Con Agentes IA

• Commit temprano y frecuente
• Code review cada 3-4 tareas
• Pedir plan antes de implementar
• Tests de integración lo antes posible
• Actualizar spec si se descubre algo nuevo

En el Equipo

• Spec escrita en colaboración (Product+Eng+QA)
• La calidad no depende del prompting individual
• Junior siguiendo el flujo = resultados de senior

---

🎯 Conclusión

> SDD no es Waterfall. Es la respuesta a: IA genera código rápido, pero velocidad sin dirección = deuda técnica.

Próximos pasos:

1. Piloto con una feature real
2. Definir constitución del proyecto
3. Capacitar al equipo
4. Iterar y ajustar

Visión: El ingeniero evoluciona de escribir código → definir intención → validar propósito.

---

📖 Glosario Rápido