Tutorial de GitHub Spec-Kit

Bienvenido al tutorial completo de Spec-Kit, el toolkit de GitHub para desarrollo dirigido por especificaciones (Spec-Driven Development).

¿Qué es Spec-Kit?

Spec-Kit es una herramienta que invierte el paradigma tradicional de desarrollo de software. En lugar de escribir código primero y documentar después, Spec-Kit permite que las especificaciones se conviertan en implementaciones ejecutables.

¿Por qué usar Spec-Kit?

• Claridad desde el inicio: Define el “qué” antes del “cómo”
• Reducción de errores: Especificaciones claras reducen malentendidos
• Documentación viva: Las especificaciones están siempre actualizadas
• Integración con AI: Funciona con Claude Code, Copilot y otros agentes

Contenido del Tutorial

Módulo 1: Fundamentos

• Introducción a Spec-Driven Development

  • Qué problema resuelve
  • Diferencia con desarrollo tradicional
  • Cuándo usarlo

• Instalación y Configuración

  • Requisitos del sistema
  • Instalación con uv
  • Configuración con agentes AI

Módulo 2: Flujo de Trabajo

• Comandos y Flujo de Trabajo
  • /speckit.constitution
  • /speckit.specify
  • /speckit.plan
  • /speckit.tasks
  • /speckit.implement

Módulo 3: Práctica

• Ejemplo Práctico

  • Proyecto de principio a fin
  • Cada comando en acción

• Mejores Prácticas

  • Tips para buenas especificaciones
  • Errores comunes a evitar

Prerrequisitos

Para seguir este tutorial necesitas:

• Python 3.11+ instalado
• uv (gestor de paquetes Python)
• Git configurado
• Un agente AI compatible (Claude Code, Copilot, Cursor)

Instalación Rápida

# Instalar uv si no lo tienes
curl -LsSf https://astral.sh/uv/install.sh | sh

# Instalar spec-kit
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# Verificar instalación
specify check

# Inicializar proyecto con tu agente AI
specify init mi-proyecto --ai claude

Recursos

• Repositorio: github.com/github/spec-kit
• Licencia: MIT

Última actualización: Enero 2026

Siguiente Paso

→ Capítulo 1: Introducción a Spec-Driven Development