Instala tu Spec Kit y arranca tu proyecto

El spec-driven development es una metodología, no una marca registrada ni una herramienta específica. Aquí aprenderás a preparar el entorno completo para trabajar con Spec Kit de GitHub, la herramienta que usaremos a lo largo del curso, y para quién resulta útil: cualquier desarrollador que quiera construir software con contratos técnicos claros antes de escribir código.

En teoría, podrías aplicar esta metodología hasta en un cuaderno de notas. Pero existen frameworks estandarizados que lo hacen más estructurado y ágil, como OpenSpec, Kiro o el Spec Kit de GitHub. Ese último es el protagonista de tu setup.

Qué herramientas necesitas para tu setup de Spec Kit

Antes de generar cualquier especificación, necesitas instalar seis piezas. Cada una cumple un rol puntual dentro del flujo de trabajo, y aquí te explico por qué.

• Git: gestiona las versiones de tu código. Es obligatorio porque Spec Kit corre sobre Git.
• Python: aunque tu proyecto no tenga componentes en Python, Spec Kit lo requiere para ejecutar ciertos componentes internos.
• UI: una herramienta que instala y gestiona paquetes, específicamente en Python.
• Cloud Code: el framework basado en agentes que te permite desarrollar software de forma ágil con agentes especializados.
• Spec Kit de GitHub: genera todos los contratos técnicos necesarios para tu aplicación. Es open-source y convive dentro de Cloud Code.
• Un comando de inicialización: no es una herramienta como tal, sino la instrucción que arranca tu proyecto.

Un detalle importante: Spec Kit es agnóstico respecto a la inteligencia artificial que elijas [1:04]. Puedes usarlo en Codex, Copilot, Cloud Code o cualquier framework de agentes que soporte la documentación.

¿Qué es spec-driven development? Es una metodología para desarrollar software definiendo primero las especificaciones y contratos técnicos, y luego el código. No es una herramienta ni una marca, sino una forma de trabajar que puedes implementar con frameworks como Spec Kit.

Por qué Cloud Code usa Spec Kit como skills y plugins

Y aquí viene lo interesante: Cloud Code no reemplaza a Spec Kit, lo usa. Toma esta herramienta como plugins o skills para ir poblando poco a poco cada uno de los templates que instalas [1:52].

Es decir, Cloud Code funciona como el agente que rellena los espacios, mientras Spec Kit aporta la estructura y los contratos técnicos.

Cómo inicializar tu proyecto con el comando Specify Init

Una vez instaladas las seis herramientas, toca inicializar el proyecto. Ve a la documentación oficial de Spec Kit (la encuentras en la caja de recursos) y busca la línea que indica cómo iniciar.

El comando que copiarás y pegarás en tu terminal tiene tres partes clave:

1. Specify: el comando base que la herramienta usa para inicializar todas las ejecuciones.
2. Init: la instrucción para inicializar tu proyecto, seguida del nombre del proyecto.
3. La integración de IA: en este caso reemplazas Copilot por Cloud [3:04].

En Windows usarás PowerShell; en Mac, tu terminal. Al ejecutarlo, la herramienta te pregunta dónde quieres correrla: en el Shell o en PowerShell/Python. En el ejemplo se ejecuta en el Shell por usar un sistema operativo Linux [3:20].

¿Qué hace el comando Specify Init? Inicializa tu proyecto y crea las carpetas con los templates base que Cloud Code irá completando. Es el punto de arranque de todo el flujo spec-driven.

Qué archivos y templates se instalan en tu proyecto

Después de inicializar, vale la pena abrir Visual Studio Code y revisar qué se creó [3:52]. En la carpeta de Cloud encontrarás un conjunto de recursos llamado Spec Kit: ahí están las skills que Cloud Code usará para poblar los templates.

Esos templates viven en la carpeta Specify, dentro de Templates. Ahí verás, por ejemplo, el template de Constitution [4:22]. Todavía no sabemos qué es Constitution (eso llega en el siguiente módulo), pero lo importante es entender su naturaleza.

Son archivos Markdown con placeholders, esos huecos que Cloud Code irá rellenando conforme reciba información de tu proyecto. Lo mismo aplica para:

• El plan.
• El spec.
• El task.

Con todo esto instalado y el proyecto inicializado, ya tienes la base para el módulo más importante del curso: desarrollar tu proyecto completo aplicando cada técnica del spec-driven development.

¿Te trabaste en algún paso de la instalación? Déjalo en los comentarios y lo revisamos juntos.