Extra AGuía de herramientas: dónde y cómo aplicar SDD

¿Qué herramienta uso en cada momento?

Esta guía responde una pregunta simple: cuando el módulo dice "dale la spec a la IA", ¿qué abres, dónde escribes, qué botones pulsas?

Opción A — GitHub Copilot en VSCode (entornos corporativos restringidos)

Esta es tu herramienta aprobada en el trabajo. Funciona bien para SDD si la configuras bien.

Configuración inicial (una sola vez)

1. Abre VSCode en tu proyecto
2. Navega a .github/copilot-instructions.md
   • Si no existe: créalo (clic derecho en .github → New File → copilot-instructions.md)
3. Pega tu CLAUDE.md ahí. Copilot lo lee automáticamente en cada sesión.

Cómo entregar una spec a Copilot

Opción 1 — Chat de Copilot (recomendada para SDD):

1. Ctrl + Shift + P → busca "GitHub Copilot: Open Chat" o pulsa el icono de chat en la barra lateral izquierda
2. En el chat, escribe:

Lee esta spec completa antes de escribir código.
Cuando termines, confirma qué vas a implementar y en qué orden.
Solo cuando yo diga "adelante", empieza.

[PEGA AQUÍ TU SPEC COMPLETA]

3. Espera la confirmación de la IA
4. Escribe "adelante" cuando estés de acuerdo con el plan

Opción 2 — Inline en el editor:

1. Coloca el cursor donde quieres que empiece la implementación
2. Ctrl + I → abre el inline chat
3. Escribe una instrucción corta que referencia tu spec:
   "Implementa el filtro de estado según la spec en ai/specs/en-progreso/feature-filtro.md"
4. Copilot leerá el archivo si está en el workspace

Slash commands en Copilot

En el chat de Copilot puedes crear comandos personalizados. Crea el archivo .github/copilot-instructions.md con esta sección:

## Comandos disponibles

/spec [descripción] → Genera el esqueleto de una spec para la feature descrita
/review → Revisa el último código generado contra la spec activa
/validate → Lista los criterios de validación de la spec activa para verificar manualmente
/handoff → Resume el estado actual del trabajo para retomar en otra sesión
/worklog → Registra lo que se ha hecho en esta sesión en ai/worklog.md

Limitación conocida + workaround

El portapapeles corporativo puede bloquear el copy-paste de textos largos. Workaround documentado:

1. Escribe la spec en Claude.ai (aquí)
2. Envíatela por Gmail a tu correo corporativo
3. Ábrela en el navegador del trabajo
4. Cópiala desde ahí al chat de Copilot (el portapapeles funciona desde el navegador)

Opción B — Claude.ai (proyectos personales, este curso)

Para tus proyectos personales y para este curso, Claude.ai es la opción más directa.

Cómo funciona para SDD

No necesitas configuración especial. El flujo es:

1. Abre una conversación nueva en claude.ai
2. Al inicio de cada sesión de trabajo, pega tu CLAUDE.md del proyecto:

Contexto del proyecto para esta sesión:

[PEGA AQUÍ EL CONTENIDO DE TU CLAUDE.md]

3. Luego pega la spec:

Spec a implementar:

[PEGA AQUÍ TU SPEC COMPLETA]

Lee ambos documentos. Confirma qué vas a implementar antes de empezar.

4. Cuando confirme, di "adelante"

Limitación: Claude.ai no recuerda entre conversaciones

Cada conversación empieza desde cero. Por eso el CLAUDE.md es crítico: es la memoria que tú le inyectas manualmente al inicio de cada sesión.

Opción C — Claude Code CLI (la más potente, requiere instalación)

Claude Code es la herramienta ideal para SDD porque tiene memoria de proyecto nativa. Lee el CLAUDE.md automáticamente al iniciarse en una carpeta.

Instalación

# Requiere Node.js 18+
npm install -g @anthropic-ai/claude-code

# Verificar instalación
claude --version

Primer uso en un proyecto

# Navegar al proyecto
cd /ruta/a/tu/proyecto

# Iniciar Claude Code
claude

# Claude Code lee automáticamente CLAUDE.md si existe en la carpeta
# Si no existe, te pregunta si quieres crearlo

Flujo SDD con Claude Code

# 1. Inicia Claude Code en la carpeta del proyecto
claude

# 2. Claude Code ya tiene el contexto del CLAUDE.md
# Dile directamente qué spec implementar:
> Lee la spec en ai/specs/en-progreso/feature-filtro.md
> Confirma qué vas a implementar antes de empezar

# 3. Cuando confirme:
> adelante

# 4. Claude Code puede leer, crear y modificar archivos directamente
# No necesitas copiar y pegar código

Skills en Claude Code

Los skills son archivos markdown que definen comportamientos. Se guardan en .claude/skills/ dentro del proyecto.

Crea .claude/skills/sdd.md:

# skill: sdd-implementation

Cuando recibas una spec para implementar:
1. Lee todos los bloques de la spec antes de escribir código
2. Confirma en un párrafo qué vas a implementar y en qué orden
3. Espera confirmación antes de empezar
4. Implementa solo lo definido en COMPORTAMIENTO ESPERADO
5. Respeta todas las RESTRICCIONES sin excepciones
6. Genera tests para cada CRITERIO DE VALIDACIÓN
7. No implementes nada en FUERA DE ALCANCE
8. Si hay ambigüedad, pregunta antes de asumir
9. Al terminar, lista qué criterios de validación puedes verificar automáticamente

Opción D — Cursor o Windsurf (alternativa a VSCode)

Si en algún momento usas Cursor o Windsurf, el flujo SDD es casi idéntico a VSCode + Copilot.

Cursor

• El archivo de contexto se llama .cursorrules (en la raíz del proyecto)
• Pega ahí el contenido de tu CLAUDE.md
• El chat de Cursor (Ctrl + L) acepta specs exactamente igual que Copilot

Windsurf

• El archivo de contexto es .windsurfrules
• Mismo principio: pega el CLAUDE.md ahí
• El chat se abre con Ctrl + L también

Tabla resumen: ¿cuándo uso qué?

Configuración mínima para empezar hoy

Si quieres empezar el M1 ahora mismo sin instalar nada:

1. Abre claude.ai en el navegador (ya lo tienes)
2. Crea una carpeta en tu ordenador llamada sdd-practica/
3. Dentro, crea un archivo mi-primera-spec.md
4. Escribe la spec del ejercicio del M1 en ese archivo
5. Pégala aquí en el chat para revisión

Eso es todo. Sin instalaciones, sin configuraciones. Empiezas a aprender SDD escribiendo specs, no configurando herramientas. Las herramientas se optimizan después, cuando ya tienes el método claro.