🤖 Integración con GitHub Spec Kit

---

🌍 Par de idioma / Language pair

• Español: 08-integracion-github-spec-kit.md
• English: ../en/08-github-spec-kit-integration.md

🗣️ Prompt amigable (copiar y pegar)

Usa esto cuando no eres técnico y quieres que la IA haga la integración + guía completa:

Usando https://github.com/juanklagos/spec-driven-development-template, crea todo lo necesario para llevar a cabo mi proyecto de principio a fin.
Mi proyecto es: [explica tu proyecto en lenguaje simple].

Si mi proyecto es nuevo, inicialízalo con este template y GitHub Spec Kit.
Si mi proyecto ya existe, adáptalo a idea/specs/bitacora sin romper el comportamiento actual.
Guíame paso a paso según mi nivel (principiante/intermedio/avanzado), con lenguaje claro.
No omitas especificación, plan, tareas, traza de refinamiento, bitácora y validación.

[!TIP] Para inicio rápido y prompts, usa:

• AI_START_HERE.md
• Matriz de prompts
• Banco de prompts validados

Esta plantilla recomienda usar GitHub Spec Kit como motor de flujo de trabajo.

[!NOTE] Desde finales de 2025 todos los comandos de Spec Kit viven bajo el namespace speckit.* (docs antiguas muestran /specify, /plan, etc.). Spec Kit soporta 30+ agentes de IA (Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI, Windsurf…).

Mapa rápido (set de comandos actual)

Fase	Comando	Propósito	¿Requerido?
1	/speckit.constitution	Definir principios del proyecto	Recomendado
2	/speckit.specify	Definir qué se construye y por qué	Sí
3	/speckit.clarify	Resolver preguntas abiertas antes de planificar	Opcional
4	/speckit.plan	Definir cómo se construye	Sí
5	/speckit.tasks	Generar tareas ejecutables	Sí
6	/speckit.analyze	Verificar consistencia spec/plan/tareas	Opcional
7	/speckit.checklist	Generar checklists de calidad	Opcional
8	/speckit.taskstoissues	Convertir tareas en issues de GitHub	Opcional (equipos)
9	/speckit.implement	Ejecutar implementación	Sí

Flujo visual

flowchart LR
  A["Constitución"] --> B["Especificación"]
  B --> B2["Clarify (opcional)"]
  B2 --> C["Plan"]
  C --> D["Tareas"]
  D --> D2["Analyze + Checklist (opcional)"]
  D2 --> E["Implementación"]
  E --> F["Bitácora + Refinamiento"]

Cómo encajan los comandos opcionales con la compuerta de este template

• /speckit.clarify antes de planificar reduce el ir y venir que suele bloquear la aprobación de la spec.
• /speckit.analyze es el paso natural justo antes de ./scripts/check-sdd-gate.sh .: verifica consistencia entre spec.md, plan.md y tasks.md; la compuerta verifica luego aprobación + consentimiento.
• /speckit.checklist complementa los checklists de calidad por etapa de este template.
• /speckit.taskstoissues es útil en modo equipo para asignar tareas como issues de GitHub.

Instalación recomendada

Opción 1: instalación persistente

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

Opción 2: uso puntual

uvx --from git+https://github.com/github/spec-kit.git specify init <NOMBRE_PROYECTO>

Inicializar en proyecto existente

specify init . --ai codex
# o
specify init --here --ai codex

También puedes usar ejecución puntual:

uvx --from git+https://github.com/github/spec-kit.git specify init . --ai codex

Inicialización recomendada con este template

Si ya tienes este template en local, puedes arrancar un proyecto nuevo y dejar Spec Kit listo en un solo paso:

./scripts/init-project-with-spec-kit.sh /ruta/proyecto codex

Relación con esta plantilla

• idea/ define intención general.
• specs/ guarda especificaciones numeradas.
• bitacora/ mantiene trazabilidad real.

Recomendación práctica

Después de usar comandos de Spec Kit, actualiza siempre:

• specs/INDEX.md
• history.md de la spec activa
• bitacora/global/PROJECT_LOG.md
• bitacora/diaria/
• bitacora/handoffs/ si dejas trabajo pendiente

Y valida:

./scripts/validate-sdd.sh . --strict
./scripts/check-sdd-gate.sh .

💡 Tips rápidos

• Empieza con una descripción corta del proyecto en lenguaje simple.
• Pide a la IA confirmar la spec activa antes de programar.
• Cierra cada sesión con validación y próximo paso claro.

📊 Flujo visual

flowchart LR
  A["Idea del proyecto"] --> B["Spec aprobada"]
  B --> C["Plan alineado"]
  C --> D["Tareas priorizadas"]
  D --> E["Implementación"]
  E --> F["Validación + Bitácora"]