Spec Kit — Flujo de cambios spec-driven para SmallCountry¶

Sustituirá el proceso manual de proponer, planificar y ejecutar cambios en la infraestructura. Será el método oficial por el que cualquier modificación estructural de SmallCountry pasará de idea a despliegue.

Como usuario

Qué podrás hacer¶

Proponer un cambio en SmallCountry con un comando estructurado (/speckit.specify)
Ver el plan técnico generado antes de que se ejecute nada
Seguir el progreso de tu propuesta mediante tareas accionables
Tener trazabilidad completa: spec → plan → tareas → implementación

Cómo accederás¶

Plataforma	Cómo
Navegador	Vía Forgejo (`forgejo.sc/smallcountry/infra-core`)
Terminal	`specify` CLI local
Hermes Agent	Comandos `/speckit.*` desde chat

Primeros pasos¶

Clonar el repo: git clone forgejo.sc/smallcountry/infra-core
Tener uv instalado y specify-cli
Leer docs/specs/flujo.md para entender el proceso
Proponer primer cambio con Hermes Agent o manualmente

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Forgejo	Spec Kit vivirá dentro del repo `infra-core`. Cada spec generará PRs en Forgejo
Hermes Agent	Ejecutará los comandos `/speckit.*`. Spec Kit estructurará, Hermes ejecutará
MkDocs	La documentación se actualizará como parte de las tareas de implementación
Ansible	Los planes técnicos referenciarán playbooks y roles Ansible

Servicios que lo harán posible¶

Spec Kit (CLI) — generará .specify/ con templates y constitución
Hermes Agent — ejecutor de los comandos spec-driven
uv — instalador de Python para specify-cli
Git — todo cambio será un commit versionado

Para el administrador

Datos del servicio¶


LXC	N/A — herramienta CLI, no servicio persistente
Ubicación	`~/.local/bin/specify`
Instalación	`uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@v0.0.22`

Archivos que generará en el repo¶

.specify/
├── memory/
│   └── constitution.md    ← Las 13 reglas Zen
└── templates/
    ├── spec-template.md
    ├── plan-template.md
    └── tasks-template.md

specs/
└── 001-ejemplo/
    ├── spec.md
    ├── plan.md
    └── tasks.md

Actualización¶

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

Para el arquitecto

Relaciones con otros servicios¶

flowchart LR
    Arquitecto -->|/speckit.specify| Hermes[Hermes Agent]
    Hermes -->|Genera spec| Specs[specs/]
    Specs -->|PR| Forgejo[Forgejo]
    Forgejo -->|Actions| ZenCheck[Zen-check CI]
    ZenCheck -->|✅| Merge[Merge]
    Merge -->|Actualiza| Docs[MkDocs]
    Merge -->|Despliega| Ansible[Ansible]

Flujo de trabajo¶

Fase	Comando	Output
Especificar	`/speckit.specify`	`specs/XXX-nombre/spec.md`
Planificar	`/speckit.plan`	`specs/XXX-nombre/plan.md`
Desglosar	`/speckit.tasks`	`specs/XXX-nombre/tasks.md`
Implementar	`/speckit.implement`	PR + cambios en el repo

Relación con los principios¶

Fuente única de verdad: cada cambio nacerá como spec versionada en git
Presupuesto de complejidad: la constitución Zen bloqueará specs que excedan límites
Conocimiento compartido: las specs documentarán el porqué de cada decisión
Reconstruibilidad: specs + ADRs permitirán entender y recrear cualquier cambio pasado

🟢 Enlaces de interés¶

Sitio oficial · Documentación · GitHub