Skip to content

08-integracion-github-spec-kit.md

Latest commit

 

History

History
133 lines (92 loc) · 3.6 KB

08-integracion-github-spec-kit.md

File metadata and controls

133 lines (92 loc) · 3.6 KB
Raw

🤖 Integración con GitHub Spec Kit

Volver al índice

🌍 Par de idioma / Language pair

🗣️ 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:

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

Mapa rápido

Fase Comando Propósito
1 /speckit.constitution Definir principios del proyecto
2 /speckit.specify Definir qué se construye
3 /speckit.plan Definir cómo se construye
4 /speckit.tasks Generar tareas ejecutables
5 /speckit.implement Ejecutar implementación

Flujo visual

flowchart LR
  A["Constitución"] --> B["Especificación"]
  B --> C["Plan"]
  C --> D["Tareas"]
  D --> E["Implementación"]
  E --> F["Bitácora + Refinamiento"]
Loading

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"]
Loading