# Instalar el Spec Kit en GitHub

> **Qué es:** Guía para montar el Spec Kit (templates del módulo 03) dentro de un repositorio de GitHub, con Issue Forms y PR template incluidos.
> **Cuándo usarlo:** Al crear un repo nuevo, o para llevar SDD a un repo existente del equipo. Toma menos de 10 minutos.
> **Cómo usarlo:** Sigue los 4 pasos de abajo. Los archivos `.yml` y el PR template vienen en este mismo kit de descargas.

---

## Estructura final en tu repo

```
tu-repo/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── spec.yml                  # Form: proponer una spec
│   │   ├── adr.yml                   # Form: registrar un ADR
│   │   ├── rfc.yml                   # Form: abrir un RFC
│   │   └── config.yml                # Desactiva issues en blanco
│   └── PULL_REQUEST_TEMPLATE.md      # Checklist en cada PR
├── spec-kit/
│   ├── templates/                    # Los 7 templates del módulo 03
│   │   ├── spec-template.md
│   │   ├── plan-template.md
│   │   ├── tasks-template.md
│   │   ├── checklist-template.md
│   │   ├── adr-template.md
│   │   └── rfc-template.md
│   ├── active/                       # Specs en curso
│   └── archive/                      # Specs completados (inmutables)
└── CONSTITUTION.md                   # constitution-template.md completado
```

## Paso 1 — Crear las carpetas

```bash
mkdir -p .github/ISSUE_TEMPLATE spec-kit/templates spec-kit/active spec-kit/archive
```

## Paso 2 — Copiar los templates

Descarga los 7 templates del módulo 03 y colócalos en `spec-kit/templates/`.
Completa `constitution-template.md` con tu equipo y guárdalo como `CONSTITUTION.md` en la raíz.

## Paso 3 — Instalar los Issue Forms y el PR template

Copia de este kit:

- `spec.yml`, `adr.yml`, `rfc.yml` y `config.yml` → `.github/ISSUE_TEMPLATE/`
- `PULL_REQUEST_TEMPLATE.md` → `.github/`

```bash
git add .github spec-kit CONSTITUTION.md
git commit -m "chore: instalar Spec Kit"
git push
```

## Paso 4 — Verificar

1. En GitHub, ve a **Issues → New issue**: deben aparecer los formularios "Spec", "ADR" y "RFC".
2. Abre un PR de prueba: debe cargar el checklist automáticamente.

## Flujo de trabajo resultante

1. Una idea entra como issue tipo **Spec** (el form obliga a llenar lo esencial).
2. La spec completa se desarrolla en `spec-kit/active/` con `spec-template.md`.
3. Pasa el quality gate (`checklist-template.md`) → se crea plan y tasks.
4. Cada PR exige confirmar en el checklist que respeta la spec y la constitución.
5. Al implementarse, la spec se mueve a `spec-kit/archive/` y no se toca más.