Curso Spec-Driven Development con GitHub Spec Kit

Este curso de Spec-Driven Development con GitHub Spec Kit te enseña la metodología que está transformando el desarrollo de software: en lugar de que las especificaciones guíen el código, las especificaciones generan el código. Aprenderás a dominar GitHub Spec Kit, la herramienta open source de GitHub que estructura todo el flujo desde la idea inicial hasta la implementación final, utilizando agentes IA como Claude Code, Gemini CLI, Cursor o Copilot.

El curso está diseñado para developers que ya programan y quieren incorporar SDD como metodología de trabajo en sus proyectos, ya sean greenfield o brownfield. No se trata de vibe coding: SDD proporciona estructura, gobernanza y trazabilidad a cada decisión técnica.

Público objetivo

• Developers de cualquier stack que quieran estructurar su trabajo con agentes IA de forma profesional
• Ingenieros de software que buscan metodologías para reducir la brecha entre requisitos e implementación
• Programadores que ya usan herramientas como Claude Code, Cursor, Copilot o Gemini CLI y quieren un workflow más robusto
• Tech leads técnicos que quieren adoptar SDD en sus equipos de desarrollo

Prerrequisitos: experiencia previa programando, familiaridad con Git y línea de comandos, y acceso a al menos un agente IA compatible (Claude Code, Cursor, Copilot, Gemini CLI, etc.).

Contenido del roadmap

Fundamentos de Spec-Driven Development

• Qué es SDD: la inversión de poder donde las especificaciones generan código en vez de solo guiarlo
• Principios core: especificaciones como lingua franca, refinamiento continuo, feedback bidireccional y exploración creativa
• Fases de desarrollo: greenfield (0-to-1), exploración creativa con implementaciones paralelas e iteración brownfield
• Ecosistema de herramientas: comparativa de Spec Kit, Open Spec y otras herramientas SDD disponibles

Instalación y configuración de Spec Kit

• Prerrequisitos: Python 3.11+, uv, Git y agentes IA compatibles
• Specify CLI: instalación persistente con uv tool install, soporte cross-platform Bash/PowerShell y verificación con specify check
• Inicialización de proyectos: opciones de specify init como --ai, --script, --here, --force
• Estructura generada: directorios .specify/, scripts/, templates/ y sus funciones
• Sistema de memoria: cómo .specify/memory/ persiste contexto entre comandos y sesiones, y qué información almacena
• Actualización de Spec Kit: flujo specify init --here --force para actualizar en proyectos existentes, backup de constitution.md y gestión de conflictos

Constitución del proyecto

• Comando /speckit.constitution: crear los principios de gobernanza que guían todo el desarrollo
• Los artículos de la constitución: Library-First, CLI Interface, Test-First, Simplicity, Anti-Abstraction, Integration-First y otros principios frecuentes
• Personalización: adaptar la constitución a tu equipo, stack tecnológico y restricciones organizacionales
• Enmiendas: proceso de evolución controlada de los principios con versionado semántico

Especificación de features

• Comando /speckit.specify: transformar un prompt en una especificación estructurada con user stories y criterios de aceptación
• Anatomía de una spec: user stories, NFRs, marcadores [NEEDS CLARIFICATION] y checklists de completitud
• Comando /speckit.clarify: resolver ambigüedades de forma estructurada antes de la planificación técnica
• Feature branching: numeración automática, creación de ramas semánticas y estructura de directorios por feature

Planificación técnica

• Comando /speckit.plan: generar el plan de implementación con stack tecnológico, contratos API y modelo de datos
• Artefactos generados: plan.md, research.md, data-model.md, contracts/ y quickstart.md
• Pre-Implementation Gates: checkpoints obligatorios de simplicidad, anti-abstracción e integración

Tareas, análisis e implementación

• Comando /speckit.tasks: generar lista de tareas accionables con dependencias, paralelización y file paths
• Estructura de tasks.md: organización por user story, marcadores [P] para tareas paralelas y checkpoints de validación
• Comando /speckit.analyze: validación cruzada de consistencia entre especificación, plan y tareas
• Comando /speckit.implement: ejecución completa del plan respetando el orden de dependencias
• Implementación por fases: dividir proyectos complejos en fases para evitar saturación del contexto del agente IA
• Comando /speckit.checklist: generar checklists de calidad como "unit tests para requisitos"

Integración con agentes IA y configuración avanzada

• Agentes soportados y limitaciones: Claude Code, Gemini CLI, Cursor, Copilot, Codex CLI, Windsurf y más — incluyendo qué agentes descubren todos los slash commands y cuáles tienen restricciones
• Configuración por agente: directorios específicos, formatos de comando (Markdown/TOML) y archivos de contexto
• Sistema de templates: cómo los templates internos definen el comportamiento de cada slash command y cómo personalizarlos
• Extensiones y hooks: catálogos de extensiones, capas de configuración, hooks pre-specify, post-specify, prepare-feature-num y post-checkout con soporte cross-platform
• Configuración avanzada: variable SPECIFY_FEATURE, trabajo sin Git y opciones como --ai-skills

Objetivos de aprendizaje

Al completar este roadmap, serás capaz de:

• Comprender y aplicar la metodología Spec-Driven Development en proyectos de software reales
• Instalar y configurar GitHub Spec Kit con tu agente IA preferido, incluyendo actualizaciones y gestión de memoria
• Crear constituciones de proyecto que garanticen consistencia arquitectónica y calidad de código
• Escribir especificaciones ejecutables que generen implementaciones completas y verificables
• Dominar los 8 comandos de Spec Kit: constitution, specify, clarify, plan, analyze, tasks, implement y checklist
• Planificar implementaciones con trazabilidad completa desde requisitos hasta tareas concretas, aplicando implementación por fases
• Integrar SDD en flujos de trabajo existentes con cualquiera de los 16+ agentes IA soportados, conociendo sus limitaciones reales
• Personalizar templates, extensiones y hooks para adaptar Spec Kit a las necesidades de tu equipo