Dashboard de status y roadmap automático

Cómo hacer Pasos para una tarea concreta. Da por sabido lo básico.

---

🌍 Par de idioma / Language pair

• Español: 29-dashboard-status-y-roadmap.md
• English: ../en/29-status-dashboard-and-auto-roadmap.md

🗣️ Prompt amigable (copiar y pegar)

Úsalo si no eres técnico y quieres que la IA lo integre todo y te vaya guiando:

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.

Herramientas automatizadas para visualizar el progreso de tu proyecto y generar roadmaps desde tus specs.

🛠️ Scripts disponibles

./scripts/generate-status.sh

Qué hace: Escanea todas las specs en specs/ y genera STATUS.md — un tablero mostrando:

• Specs activas con status, prioridad y responsable
• Progreso de tareas (pendientes vs. completadas en todas las specs)
• Extractos recientes de la bitácora de bitacora/global/PROJECT_LOG.md

Cómo usar:

./scripts/generate-status.sh

Output: Actualiza STATUS.md en la raíz del proyecto.

Cuándo ejecutar: Después de cada sesión donde actualices specs o completes tareas.

---

./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