Spec-Driven Development con Asistentes de IA
Metodología estructurada para desarrollo asistido por IA en CLI
🎓 Bienvenido al Curso de SDD con IA
👨🏫 Del Instructor: Este curso te guiará desde la historia de la programación hasta las técnicas más avanzadas de Spec-Driven Development con Kilocode CLI y Neovim.
💭 Mentalidad de Arquitecto: “Un buen asistente de IA es como un junior brillante: necesita especificaciones claras para brillar, no instrucciones vagas para fallar.”
🎯 ¿Por Qué Este Curso?
En febrero 2025, Andrej Karpathy definió “vibe coding” como la práctica de generar código con IA sin entenderlo completamente. El resultado: 25% de startups YC tienen 95% código IA generado [1].
“There’s a new kind of coding I call ‘vibe coding’, where you fully give in to the vibes, embrace exponentials, and forget that the code even exists.”
— Andrej Karpathy [2]
“Hay un nuevo tipo de codificación que llamo ‘vibe coding’, donde te entregas completamente a las vibras, abrazas los exponenciales y olvidas que el código siquiera existe.”
Pero hay un problema:
- Alucinaciones: IA genera código incorrecto con confianza
- Inconsistencia: Mismo prompt, diferentes resultados
- Falta de trazabilidad: ¿Por qué se tomó esta decisión?
- Dificultad de mantenimiento: Código sin documentación
SDD resuelve esto proporcionando especificaciones estructuradas que guían tanto al humano como a la IA.
📚 Objetivos de Aprendizaje
Al completar este curso, serás capaz de:
- Comprender la evolución desde assembly hasta specs
- Diferenciar vibe coding de SDD
- Aplicar Context Architecture y Task-Driven Development
- Comparar herramientas: Kiro, Spec Kit, Tessl
- Implementar SDD en Kilocode CLI + Neovim
- Configurar MCP servers para potenciar el workflow
- Aplicar patrones avanzados en proyectos reales
📋 Prerrequisitos
| Conocimiento | Nivel Requerido |
|---|---|
| Git básico | Intermedio |
| Terminal/CLI | Intermedio |
| Neovim | Básico |
| JavaScript/Python | Básico |
| Asistentes de IA | Principiante |
Herramientas Necesarias
- Kilocode CLI o Opencode [3], [4]
- Neovim (editor de código)
- Node.js 18+ (para MCP servers)
- Git
- API key del proveedor de LLM (Anthropic, OpenAI, etc.)
🗺️ Estructura del Curso
Módulo 0: Contexto Histórico 🆕
- 60 años de abstracción en programación
- Vibe Coding: definición, uso, riesgos
- La evolución natural hacia SDD
Módulo 1: Introducción a SDD
- ¿Qué es Spec-Driven Development?
- 3 niveles: spec-first, spec-anchored, spec-as-source
- Las 8 fases del workflow
- Tipos de especificaciones
Módulo 1B: Context Architecture vs Prompt Engineering 🆕
- Por qué Prompt Engineering es un dead end
- Context Architecture: contexto como artefacto de ingeniería
- La Regla 80/20: 80% planeando, 20% ejecutando
- Master Spec vs Task Spec
- Metaprompting: técnica experta
Módulo 1C: Task-Driven Development 🆕
- El Vibe Coding Trap: 50% pérdida de productividad
- Las 6 fases del ciclo de vida de una tarea
- Enhanced Task Template para tareas complejas
- Human design, AI production
- Specialized subagents: Taskie y Archie
Módulo 2: Comparativa de Herramientas 🆕
Módulo 3: SDD en Kilocode CLI
- Configuración CLI
- Estructura de skills
- Integración con Neovim
Módulo 4: SDD en Opencode
- Configuración del proyecto
- Diferencias con Kilocode
Módulo 5: Práctica Guiada
- Caso real: Health endpoint
- Paso a paso con CLI + Nvim
- Verificación y archivado
Módulo 6: Integración MCP
Módulo 7: Patrones Avanzados
- Context window management
- Brownfield vs Greenfield
- Spec evals y calidad
- Legacy applications
- Spec Registries
📊 Progreso del Curso
| Módulo | Duración | Dificultad | Estado |
|---|---|---|---|
| 0. Contexto Histórico | 45 min | 🟢 Básico | 🆕 Nuevo |
| 1. Introducción a SDD | 30 min | 🟢 Básico | ✅ |
| 1B. Context Architecture | 45 min | 🟡 Intermedio | 🆕 Nuevo |
| 1C. Task-Driven Development | 45 min | 🟡 Intermedio | 🆕 Nuevo |
| 2. Comparativa Herramientas | 45 min | 🟡 Intermedio | 🆕 Nuevo |
| 3. Kilocode CLI | 45 min | 🟡 Intermedio | ✅ |
| 4. Opencode | 30 min | 🟡 Intermedio | ✅ |
| 5. Práctica Guiada | 60 min | 🟡 Intermedio | ✅ |
| 6. MCP Integration | 45 min | 🔴 Avanzado | ✅ |
| 7. Patrones Avanzados | 60 min | 🔴 Avanzado | 🔄 Ampliado |
Tiempo total estimado: 8-9 horas
🛠️ Stack Tecnológico del Curso
┌─────────────────────────────────────────────┐
│ Modelos de LLM │
│ (Anthropic, OpenAI, etc.) │
└─────────────────────────────────────────────┘
│
┌───────────┴───────────┐
▼ ▼
┌───────────────┐ ┌───────────────┐
│ Kilocode CLI │ │ Opencode │
│ (CLI #1) │ │ (CLI #2) │
└───────────────┘ └───────────────┘
│ │
└───────────┬───────────┘
│
┌───────────┴───────────┐
▼ ▼
┌───────────────┐ ┌───────────────┐
│ Neovim │ │ MCP Servers │
│ (Editor) │ │ (Extensions) │
└───────────────┘ └───────────────┘🎭 Escenario Real
Eres desarrollador en un equipo. Tu empresa adoptó IA para desarrollo:
- Semana 1: “¡Wow! La IA genera código súper rápido”
- Semana 4: “¿Por qué este código no funciona como esperábamos?”
- Semana 8: “Nadie entiende cómo funciona el módulo de pagos”
- Semana 12: “¿Quién decidió usar esta biblioteca? ¿Por qué?”
Sin SDD: Caos técnico, deuda invisible, inconsistencia
Con SDD: Trazabilidad, decisiones documentadas, código predecible
🚀 Comenzando
Dirígete al Módulo 0: Contexto Histórico para comenzar tu journey desde los orígenes hasta el estado del arte.
👨🏫 Sobre el Autor
Diego Saavedra es Software Developer FullStack, Móvil e IA con más de 10 años de experiencia. Docente universitario en ESPE, UIDE, IST Juan Montalvo, Abacom y Codings Academy. Explorador del ecosistema de seguridad informática desde una perspectiva de desarrollo seguro.
📖 Referencias
Curso v3.0 | Actualizado: 2026-02-24 | © Diego Saavedra