Herramientas SDD y ecosistema actual

GitHub Spec Kit

GitHub Spec Kit es el toolkit de SDD desarrollado por GitHub como proyecto open source con licencia MIT. Es la herramienta que ha popularizado el concepto de Spec-Driven Development y la que cuenta con mayor adopción en la comunidad, con más de 70.000 estrellas en GitHub.

Spec Kit se compone de dos elementos principales:

• Specify CLI: una herramienta de línea de comandos escrita en Python que inicializa proyectos con la estructura necesaria para SDD. Se instala con uv y genera el scaffolding de carpetas, templates y scripts adaptados al agente IA que el usuario elija.

• Templates y scripts: un conjunto de archivos markdown que definen la estructura de cada artefacto SDD (especificaciones, planes, tareas) y scripts auxiliares que automatizan la gestión de features, ramas y contexto del agente.

Flujo de trabajo

Spec Kit estructura el desarrollo en fases ejecutadas mediante slash commands que se invocan dentro del agente IA:

| Comando | Fase | Qué produce | |---|---|---| | /speckit.constitution | Gobernanza | Principios inmutables del proyecto | | /speckit.specify | Especificación | User stories, criterios de aceptación, NFRs | | /speckit.clarify | Clarificación | Resolución de ambigüedades marcadas | | /speckit.plan | Planificación | Stack, arquitectura, contratos, modelo de datos | | /speckit.analyze | Análisis | Validación cruzada de consistencia | | /speckit.tasks | Tareas | Lista de tareas con dependencias y checkpoints | | /speckit.implement | Implementación | Código generado según las tareas | | /speckit.checklist | Validación | Checklist de cumplimiento de requisitos |

El flujo es secuencial pero iterativo: cada fase produce artefactos que alimentan la siguiente, y los descubrimientos en fases posteriores pueden motivar revisiones de artefactos anteriores.

Spec Kit proporciona ocho slash commands que cubren el ciclo completo de SDD, desde la definición de principios de gobernanza hasta la validación final de requisitos.

Estructura de proyecto

Al ejecutar specify init, Spec Kit genera una estructura de directorios que organiza los artefactos SDD:

proyecto/
  .specify/
    memory/
      constitution.md
    templates/
      spec-template.md
      plan-template.md
      tasks-template.md
    scripts/
      bash/ o powershell/
  .github/agents/   (o .claude/commands/, .cursor/commands/, .gemini/commands/, etc.)
    speckit.constitution.agent.md
    speckit.specify.agent.md
    speckit.plan.agent.md
    ...
  specs/
    feature-001/
      spec.md
      plan.md
      tasks.md

La carpeta .specify/ contiene los templates y la memoria compartida del proyecto (incluyendo la constitución). La carpeta específica del agente (.github/agents/ para Copilot, .cursor/commands/ para Cursor, etc.) contiene las definiciones de los slash commands que Spec Kit genera para cada agente. La carpeta specs/ alberga los artefactos generados para cada feature.

Soporte de agentes

Una de las características distintivas de Spec Kit es su enfoque agnóstico respecto al agente IA. Soporta más de 20 agentes, entre los que se incluyen:

• Claude Code: soporte completo de todos los slash commands.
• GitHub Copilot: integración nativa a través de .github/agents/.
• Cursor: soporte mediante .cursor/commands/.
• Gemini CLI: compatible con los templates de Spec Kit.
• Windsurf, Codex CLI, Aider: soportados con distintos niveles de integración.

No todos los agentes descubren automáticamente todos los slash commands. Algunos requieren invocación manual de los prompts o configuración adicional. Este matiz es relevante a la hora de elegir agente para un proyecto SDD.

OpenSpec

OpenSpec es un framework de SDD desarrollado por Fission AI que toma un enfoque diferente al de Spec Kit. Mientras que Spec Kit fragmenta las especificaciones en múltiples archivos por feature, OpenSpec mantiene un documento unificado que actúa como fuente de verdad única del proyecto.

Filosofía

OpenSpec se describe como "fluido, no rígido; iterativo, no waterfall; fácil, no complejo". Su diseño prioriza la velocidad de iteración sobre la exhaustividad de la estructura. Donde Spec Kit genera varios documentos (spec, plan, tasks, research, data-model, contracts), OpenSpec condensa la información relevante en un único archivo que evoluciona mediante cambios delta marcados como ADDED, MODIFIED o REMOVED.

Flujo de trabajo

El ciclo de trabajo en OpenSpec se resume en tres fases:

• Propose: el usuario describe una funcionalidad y OpenSpec genera una propuesta de cambios en la especificación existente.
• Apply: los cambios propuestos se aplican al documento de especificación unificado.
• Archive: las propuestas aplicadas se archivan para mantener un historial de decisiones.

flowchart LR
    P["Propose<br>Describir cambio"] --> A["Apply<br>Actualizar spec"]
    A --> AR["Archive<br>Registrar historial"]
    AR --> P

Comparación con Spec Kit

| Aspecto | Spec Kit | OpenSpec | |---|---|---| | Modelo de especificación | Múltiples archivos por feature | Documento unificado con deltas | | Verbosidad | Alta (~800 líneas en fases tempranas) | Baja (~250 líneas al mismo nivel) | | Setup | Requiere Python, uv, ~30 min inicial | npm, setup más ligero | | Punto fuerte | Proyectos complejos, greenfield | Iteración rápida, brownfield | | Agentes soportados | 20+ agentes | 20+ agentes |

OpenSpec resulta una opción interesante para equipos que buscan adoptar SDD de forma gradual sin la inversión inicial que supone la estructura completa de Spec Kit. Su enfoque de documento unificado facilita la revisión rápida del estado completo del proyecto en un solo vistazo.

GSD

GSD (Get Stuff Done) es una herramienta que prioriza la ejecución sobre la especificación. A diferencia de Spec Kit y OpenSpec, que ponen el énfasis en la calidad de los artefactos de especificación, GSD se centra en la ingeniería de contexto: asegurar que el agente IA tenga todo el contexto necesario para ejecutar tareas de forma eficaz.

Enfoque

GSD parte de la premisa de que la calidad de la implementación depende más de la calidad del contexto que de la estructura de la especificación. Su sistema se centra en:

• Recopilar contexto automáticamente: analizar el codebase existente, dependencias, patrones arquitectónicos y convenciones del equipo.
• Estructurar el contexto para el agente: organizar la información de forma que el agente IA pueda consumirla eficientemente dentro de su ventana de contexto.
• Ejecutar con mínima ceremonia: reducir los pasos intermedios entre la intención del usuario y la implementación.

GSD es compatible con Claude Code, OpenCode y Gemini CLI, con un enfoque más orientado a desarrolladores individuales que a equipos grandes.

GSD prioriza la velocidad de ejecución y la calidad del contexto sobre la estructura formal de las especificaciones, situándose en un punto intermedio entre el vibe coding y el SDD completo.

Taskmaster AI

Taskmaster AI se especializa en la fase de orquestación de tareas. Mientras que Spec Kit y OpenSpec cubren todo el flujo desde la especificación hasta la implementación, Taskmaster se centra en optimizar la descomposición de planes en tareas ejecutables y la coordinación de su ejecución.

Características

• Descomposición inteligente: analiza planes técnicos y genera listas de tareas con dependencias explícitas, estimaciones de complejidad y criterios de validación.
• Gestión de dependencias: identifica qué tareas pueden ejecutarse en paralelo y cuáles requieren completar prerrequisitos.
• Tracking de progreso: mantiene un registro del estado de cada tarea, permitiendo retomar el trabajo donde se dejó.

Taskmaster es complementario a herramientas como Spec Kit u OpenSpec. Un equipo puede usar Spec Kit para generar especificaciones y planes, y Taskmaster para gestionar la ejecución de las tareas resultantes.

Criterios de elección

La elección de herramienta SDD depende del contexto del proyecto, el tamaño del equipo y las prioridades de cada caso. No existe una herramienta universalmente mejor, cada una optimiza para un escenario distinto.

Según el tipo de proyecto

• Proyecto greenfield complejo: Spec Kit ofrece la estructura más completa para establecer desde el inicio la constitución, especificaciones detalladas y planes técnicos con múltiples artefactos.
• Feature incremental en proyecto existente: OpenSpec facilita la iteración rápida con su modelo de deltas sobre un documento unificado, evitando la sobrecarga de crear múltiples archivos para cada feature.
• Desarrollador individual que busca estructura: GSD proporciona el contexto necesario con mínima ceremonia, manteniendo la velocidad del trabajo individual.
• Equipo con múltiples tareas paralelas: Taskmaster aporta valor cuando la coordinación de la ejecución es el cuello de botella.

Según el equipo y la organización

| Factor | Spec Kit | OpenSpec | GSD | Taskmaster | |---|---|---|---|---| | Tamaño del equipo | Medio-grande | Cualquiera | Individual-pequeño | Medio-grande | | Curva de aprendizaje | Media | Baja | Baja | Baja | | Inversión inicial | Alta | Baja | Baja | Media | | Flexibilidad del agente | Muy alta (20+) | Alta (20+) | Media (3-5) | Variable | | Gobernanza | Constitución formal | Ligera | Mínima | No aplica |

Enfoque híbrido

En la práctica, muchos equipos combinan herramientas según la fase del proyecto. Una combinación habitual es utilizar Spec Kit para la fase de especificación y planificación (aprovechando su estructura de constitución y sus templates) y complementarlo con Taskmaster para la gestión de la ejecución de las tareas generadas.

Otro patrón frecuente es comenzar con GSD o OpenSpec para proyectos pequeños o funcionalidades sencillas, y migrar a Spec Kit cuando el proyecto crece y la necesidad de gobernanza y trazabilidad aumenta.

La elección de herramienta SDD no es definitiva ni exclusiva. El ecosistema es interoperable y la mayoría de equipos acaban combinando herramientas según las necesidades de cada fase y proyecto.

El ecosistema en perspectiva

El ecosistema de herramientas SDD está en una fase de crecimiento acelerado. GitHub Spec Kit ha catalizado la adopción masiva del concepto, pero el espacio es joven y evoluciona rápidamente. Nuevas herramientas aparecen con frecuencia, y las existentes amplían sus capacidades con cada iteración.

Lo relevante no es memorizar las características de cada herramienta, sino comprender que todas comparten un principio común: definir la intención antes de la implementación. Las diferencias entre ellas son de grado, no de tipo. Spec Kit es más estructurado, OpenSpec es más ligero, GSD es más orientado a la ejecución, Taskmaster se especializa en orquestación. Pero todas buscan resolver el mismo problema: que el agente IA reciba contexto suficiente y explícito para generar implementaciones que se correspondan con la intención del equipo.

La tendencia del ecosistema apunta hacia una mayor integración entre herramientas, mejor soporte de agentes IA y flujos de trabajo cada vez más automatizados. Los principios de SDD, independientemente de la herramienta elegida, proporcionan una base sólida para navegar esta evolución.