Dashboard de status y roadmap automático

./scripts/generate-roadmap.sh

Qué hace: Lee specs/INDEX.md y genera un roadmap visual en Mermaid.

Cómo usar:

./scripts/generate-roadmap.sh

Output: Crea dos archivos:

• docs/roadmap.mmd — Fuente del diagrama Mermaid
• docs/roadmap.md — Archivo Markdown con Mermaid embebido para renderizado en GitHub

Cuándo ejecutar: Después de crear nuevas specs o cambiar prioridades en INDEX.

---

./scripts/score-spec.sh

Qué hace: Evalúa la calidad y completitud de tus especificaciones.

Cómo usar:

# Puntuar todas las specs
./scripts/score-spec.sh --all

# Puntuar una spec específica
./scripts/score-spec.sh specs/001-mi-feature

Qué verifica:

Criterio	Qué busca
Completitud de archivos	Los 5 archivos requeridos presentes (spec, plan, tasks, research, history)
Profundidad de contenido	Archivos con contenido significativo, no solo templates
Criterios de aceptación	spec.md tiene criterios claros y testeables
Desglose de tareas	tasks.md tiene checkboxes con acciones específicas
Seguimiento de historial	history.md tiene al menos una entrada

---

./scripts/new-spec.sh

Qué hace: Crea una nueva carpeta de spec numerada con todos los archivos template requeridos.

Cómo usar:

./scripts/new-spec.sh "nombre-feature" "NombreOwner"

Output: Crea specs/NNN-nombre-feature/ con templates pre-llenados.

---

📊 Flujo de trabajo recomendado

flowchart LR
  A["Crear/Actualizar Specs"] --> B["Puntuar Calidad"]
  B --> C["Generar Status"]
  C --> D["Generar Roadmap"]
  D --> E["Actualizar Bitácora"]
  E --> F["Commit & Push"]

Rutina por sesión:

1. Trabaja en tus specs e implementación
2. Ejecuta ./scripts/score-spec.sh --all para verificar calidad
3. Ejecuta ./scripts/generate-status.sh para actualizar el tablero
4. Ejecuta ./scripts/generate-roadmap.sh si cambiaron las specs
5. Actualiza la bitácora y haz commit

Ejemplo de output: STATUS.md

## Specs activas
| Número | Nombre      | Status      | Prioridad | Owner |
|--------|-------------|-------------|-----------|-------|
| 001    | user-auth   | In Progress | High      | Juan  |
| 002    | dashboard   | Draft       | Medium    | Maria |

## Progreso de tareas
- Pendientes: 12
- Completadas: 8

Ejemplo de output: roadmap.mmd

gantt
  title Roadmap del Proyecto
  section Auth
    001-user-auth :active, a1, 2026-01-01, 14d
  section UI
    002-dashboard :       a2, after a1, 10d

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