@the-bearded-bear/claude-craft 8.23.3 → 8.26.0-next.2a54921

package/Project/i18n/es/commands/migrate.md

@@ -0,0 +1,158 @@
+---
+description: "Migración puntual de un backlog existente a BMAD v6 (análisis, migración, completar stories, resincronización)"
+argument-hint: "[--analyze|--dry-run|--resync|--stories] [--force]"
+---
+
+# Migrar el backlog
+
+Migración puntual de un backlog existente a la estructura BMAD v6, con `.bmad/sprint-status.yaml` como única fuente de verdad del estado de stories y tareas (esquema: `.claude/templates/project/sprint-status.md`). Un solo comando cubre cuatro modos: análisis, migración, completar los campos que faltan en las stories y resincronización del contenido.
+
+## Uso
+
+| Invocación | Qué hace | Reemplaza |
+|------------|----------|-----------|
+| `/project:migrate --analyze` | Solo informe: estructura, puntuaciones INVEST, carencias BMAD v6. No escribe nada | `analyze-backlog` |
+| `/project:migrate` | Por defecto: migra el backlog y crea `.bmad/sprint-status.yaml` | `migrate-backlog` |
+| `/project:migrate --stories [story-id]` | Completa los campos que faltan en las stories (tareas, CA, historial, INVEST) | `update-stories` |
+| `/project:migrate --resync` | Reconcilia contenido e IDs entre el markdown y el YAML | `sync-backlog` |
+| `--dry-run` | Solo previsualización, válido para todos los modos | - |
+| `--force` | Sobrescribe los archivos BMAD existentes (modo migración) | - |
+
+## Argumentos
+
+$ARGUMENTS (formato: [--analyze|--dry-run|--resync|--stories] [--force])
+- **--analyze**: modo análisis (solo lectura)
+- **--stories**: `story-id` opcional (p. ej. US-001); si se omite, se procesan todas las stories
+- **--resync**: modo reconciliación
+- **--dry-run**: muestra lo que cambiaría, no escribe nada
+- **--force**: sobrescribe un `sprint-status.yaml` y archivos BMAD existentes
+- Los modos son mutuamente excluyentes; sin ninguno, se ejecuta la migración por defecto.
+
+## Reglas comunes
+
+- **Ubicación del backlog**, buscada en orden: `project-management/backlog/` (estándar), `docs/backlog/`, `backlog/`, `.bmad/` (ya migrado).
+- **Única fuente de verdad**: el estado vive solo en `.bmad/sprint-status.yaml`. El markdown contiene únicamente contenido (título, descripción, CA, puntos, padres).
+- **Estados heredados**: la migración inicial es el ÚNICO momento en que se leen los estados/emojis heredados del markdown; se mueven al YAML y luego se eliminan del markdown. `--resync` y `--stories` nunca copian un estado desde el markdown.
+- **Plan mode obligatorio** para la migración por defecto, `--stories` y `--resync` (salvo `--dry-run`): Claude analiza el impacto, propone un plan y espera su validación antes de modificar nada.
+- **Orden recomendado**: primero `--analyze`, luego la migración, luego `--stories`; usar `--resync` después cuando el contenido se desvíe.
+
+## --analyze
+
+Solo informe, no se modifica ningún archivo.
+
+1. **Detectar** la ubicación del backlog (ver reglas comunes).
+2. **Identificar** epics (`EPIC-*.md`, `epic*.md`), user stories (`US-*.md`, `story*.md`), tareas (`TASK-*.md` o integradas en las stories) y archivos de índice (`index.md`, `backlog.md`, `README.md`).
+3. **Analizar** por archivo: ID, título, estado heredado (🔴 To Do, 🟡 In Progress, 🟢 Done, ⏸️ Blocked), sprint, story points, padres (US → EPIC, TASK → US), número de CA, número de tareas y avance.
+4. **Puntuación INVEST** por story (0-6): Independent (sin dependencia bloqueante), Negotiable (tiene descripción), Valuable (beneficio indicado), Estimable (tiene puntos), Small (≤ 8 puntos), Testable (tiene CA).
+5. **Carencias BMAD v6**: seguimiento de la fase TDD, lista de tareas con avance, historial de estados, asignación a sprint, estado de validación de los CA.
+6. **Informe**: resumen (totales), estructura (árbol), tabla INVEST, tabla de carencias de migración (campo / % de stories afectadas / acción), recomendaciones.
+
+```
+📊 Informe de análisis del backlog
+Ubicación: project-management/backlog/ | Epics: {N} | Stories: {N} | Tareas: {N}
+
+| Story  | Título | INVEST | Falta     |
+|--------|--------|--------|-----------|
+| US-001 | Login  | 5/6    | Estimable |
+
+Carencias de migración: tdd_phase 100% | tasks.list 60% | history 100%
+Siguiente: /project:migrate
+```
+
+## Por defecto: migración
+
+1. **Validar**: crear `.bmad/` si hace falta; avisar si `sprint-status.yaml` existe y no hay `--force`; el análisis debería haberse ejecutado.
+2. **Crear la estructura**: `.bmad/sprint-status.yaml`, `batch-queue.yaml`, `gates/`, `hooks/`, `lib/`.
+3. **Analizar** cada story: metadatos, CA (Gherkin), tareas relacionadas, estado heredado, avance.
+4. **Convertir los estados heredados** al YAML:
+
+   | Origen | Estado BMAD v6 |
+   |--------|----------------|
+   | 🔴 To Do | backlog |
+   | 🟡 In Progress | in-progress |
+   | 🟢 Done | done |
+   | ⏸️ Blocked | blocked |
+   | Asignada a Sprint-X | ready-for-dev |
+
+5. **Fase TDD inicial**: 0 % de tareas terminadas → `red`; 1-99 % → `green`; 100 % → `refactor` o `done`.
+6. **Generar `sprint-status.yaml`**, una entrada por story:
+
+   ```yaml
+   stories:
+     US-001:
+       title: "User login"
+       status: "in-progress"
+       previous_status: "ready-for-dev"
+       tdd_phase: "red"
+       current_task: "TASK-001"
+       story_points: 5
+       epic_id: "EPIC-001"
+       tasks:
+         total: 4
+         completed: 2
+         list:
+           - { id: "TASK-001", title: "Backend auth endpoint", status: "in-progress", type: "BE" }
+       acceptance_criteria: { total: 3, validated: 1 }
+       history:
+         - { timestamp: "2026-01-29T10:00:00Z", from: "backlog", to: "in-progress", by: "migration", reason: "BMAD v6 migration" }
+   ```
+
+7. **Copia de seguridad** (salvo `--dry-run`): copiar el backlog en `.bmad/backup/` (con marca de tiempo) y registrar su ubicación.
+8. **Aplicar** (salvo `--dry-run`): escribir el YAML, eliminar emojis/campos de estado de los archivos markdown, crear `.bmad/migration-log.md`.
+
+Dry run: lista los archivos que se crearían (p. ej. `.bmad/sprint-status.yaml`), el número de stories/tareas/CA que se migrarían, y termina con «Run without --dry-run to apply changes.».
+
+Reversión: `tar -xzf .bmad/backup/backlog-*.tar.gz -C project-management/ && rm .bmad/sprint-status.yaml`.
+
+Pasos siguientes: revisar el YAML, ejecutar `/workflow:status`, configurar los metadatos del sprint (fechas, objetivos), comprobar los quality gates con `/gate:check all`.
+
+## --stories
+
+Completa los campos BMAD v6 que faltan en las stories existentes (todas, o una sola con `story-id`).
+
+1. **Cargar** `.bmad/sprint-status.yaml` y los archivos de stories; compararlos.
+2. **Campos que faltan** y valores por defecto:
+
+   | Campo | Requerido | Valor por defecto si falta |
+   |-------|-----------|----------------------------|
+   | tdd_phase | Sí | "red" si in-progress, "" en otro caso |
+   | tasks.list / total / completed | Sí | Extraer de `## Tasks`, contar, contar las terminadas |
+   | current_task | No | Primera tarea in-progress |
+   | history | Sí | Entrada inicial con el estado actual (`by: "migrate"`) |
+   | acceptance_criteria.total / validated | Sí | Contar en la sección CA / 0 |
+   | story_points | Sí | Preguntar al usuario si faltan |
+   | epic_id | No | Extraer del archivo |
+
+3. **Analizar las tareas** de la tabla `## Tasks` de la story y los **CA** de los bloques Gherkin `### ACn:` para rellenar `tasks.list` y `acceptance_criteria.list` (ids, títulos). Los estados de tareas y CA solo pasan al YAML para las entradas aún no seguidas allí; un estado ya presente en el YAML nunca se sobrescribe con el markdown.
+4. **INVEST**: añadir `invest_score` (independent, negotiable, valuable, estimable, small, testable, total).
+5. **Actualizar** `sprint-status.yaml` fusionando los campos; opcionalmente añadir un comentario de metadatos a los archivos de stories (`<!-- BMAD v6 Metadata … -->` con `tdd_phase`, `invest_score`, `last_sync`).
+
+Salida: tabla de stories actualizadas (campos añadidos, puntuación INVEST), resumen por campo (añadidos / omitidos), advertencias (p. ej. «US-003: faltan story points», «US-007: sin criterios de aceptación»), archivos modificados. Después corregir las advertencias, y ejecutar `/project:migrate --resync` y `/gate:check backlog`.
+
+## --resync
+
+Reconcilia contenido e IDs entre los archivos markdown y el YAML. El estado nunca se sincroniza: el YAML manda.
+
+1. **Cargar** ambas fuentes y construir un mapa de comparación por ID de story.
+2. **Detectar diferencias** de contenido: stories que faltan, títulos, story points, listas de tareas, CA, asignación.
+3. **Resolver**: el YAML es la autoridad para el estado, la fase TDD, el historial y el estado de las tareas; el markdown es la autoridad para títulos, descripciones, texto de los CA y puntos. Preguntar al usuario cuando ambos modificaron el mismo campo de contenido.
+4. **Archivos → YAML**: añadir las stories presentes solo en los archivos; actualizar títulos, puntos, listas de tareas y de CA.
+5. **YAML → archivos**: actualizar el comentario de metadatos (fase TDD, historial, puntuación INVEST, marca de sincronización); nunca escribir un estado en el markdown.
+6. **Huérfanos**: en el YAML pero no en los archivos → marcar `archived` o avisar; en los archivos pero no en el YAML → añadir al YAML (estado `backlog`).
+7. **Marcas de tiempo**: `last_sync` en el YAML y `<!-- last_sync: … -->` en los archivos de stories.
+
+Salida: cambios archivos → YAML, cambios YAML → archivos, conflictos resueltos, huérfanos (archivados / añadidos), hora de la última sincronización. Después revisar `git diff` y ejecutar `/workflow:status`.
+
+Automatización: un hook pre-commit puede ejecutar `/project:migrate --resync` (`.bmad/hooks/pre-commit.sh`).
+
+## Ejemplos
+
+```
+/project:migrate --analyze
+/project:migrate --dry-run
+/project:migrate
+/project:migrate --force
+/project:migrate --stories US-001
+/project:migrate --stories --dry-run
+/project:migrate --resync --dry-run
+```

package/Project/i18n/es/commands/move-task.md

@@ -1,204 +1,9 @@
 ---
-description: Mover una Tarea
-argument-hint: [arguments]
+description: "Obsoleto (se elimina en 9.0): usa /project:backlog move task"
+deprecated: true
+replaced-by: /project:backlog
 ---
 
-# Mover una Tarea
+> ⚠️ `/project:move-task` está obsoleto y se eliminará en 9.0. Usa `/project:backlog move task`.
 
-Cambiar el estado de una tarea siguiendo el flujo de trabajo estricto.
-
-## Argumentos
-
-$ARGUMENTS (formato: TASK-XXX destino)
-- **TASK-ID** (obligatorio): ID de la Tarea (ej., TASK-001)
-- **Destino** (obligatorio):
-  - `in-progress`: Iniciar tarea
-  - `blocked`: Marcar como bloqueada
-  - `done`: Marcar como completada
-
-## Flujo de Trabajo Estricto
-
-```
-🔴 To Do ──→ 🟡 In Progress ──→ 🟢 Done
-     │              │
-     │              ↓
-     └────→ ⏸️ Blocked ←────┘
-                │
-                ↓
-           🟡 In Progress
-```
-
-### Transiciones Permitidas
-
-| Desde | A | Permitido |
-|--------|------|----------|
-| 🔴 To Do | 🟡 In Progress | ✅ |
-| 🔴 To Do | ⏸️ Blocked | ✅ |
-| 🔴 To Do | 🟢 Done | ❌ **Prohibido** |
-| 🟡 In Progress | 🟢 Done | ✅ |
-| 🟡 In Progress | ⏸️ Blocked | ✅ |
-| 🟡 In Progress | 🔴 To Do | ✅ (rollback) |
-| ⏸️ Blocked | 🟡 In Progress | ✅ |
-| 🟢 Done | 🟡 In Progress | ⚠️ (reapertura) |
-
-## Proceso
-
-### Paso 1: Validar Tarea
-
-1. Encontrar archivo de tarea
-2. Leer estado actual
-3. Identificar US y sprint asociados
-
-### Paso 2: Validar transición
-
-1. Verificar que la transición está permitida
-2. Si To Do → Done, bloquear y sugerir In Progress
-
-### Paso 3: Si transición a Blocked
-
-Preguntar por bloqueador:
-```
-¿Cuál es el bloqueador para TASK-XXX?
-> [Descripción del bloqueador]
-```
-
-### Paso 4: Si transición a Done
-
-Preguntar por tiempo gastado:
-```
-¿Tiempo gastado en TASK-XXX? (estimación: 4h)
-> [Tiempo real, ej., 3.5h]
-```
-
-### Paso 5: Actualizar Tarea
-
-1. Modificar estado en metadatos
-2. Agregar bloqueador si está Blocked
-3. Actualizar tiempo gastado si está Done
-4. Actualizar fecha de modificación
-
-### Paso 6: Actualizar Tablero
-
-1. Leer tablero del sprint
-2. Mover tarea a nueva columna
-3. Actualizar métricas
-
-### Paso 7: Actualizar User Story
-
-1. Actualizar lista de tareas
-2. Recalcular progreso
-3. Si todas las tareas Done, sugerir completar US
-
-### Paso 8: Actualizar Índice
-
-1. Actualizar contadores globales
-
-## Formato de salida
-
-### Transición exitosa
-
-```
-✅ Tarea movida!
-
-🔧 TASK-003: Endpoint de API login
-   Antes: 🔴 To Do
-   Después: 🟡 In Progress
-
-📖 US-001: Inicio de sesión de usuario
-   Progreso: 2/6 → 3/6 (50%)
-
-Próximos pasos:
-  /project:move-task TASK-003 done       # Cuando se complete
-  /project:move-task TASK-003 blocked    # Si se bloquea
-```
-
-### Tarea completada
-
-```
-✅ Tarea completada!
-
-🔧 TASK-003: Endpoint de API login
-   Estado: 🟡 In Progress → 🟢 Done
-   Estimación: 4h
-   Tiempo real: 3.5h ✓
-
-📖 US-001: Inicio de sesión de usuario
-   Progreso: 4/6 (67%) ████████░░░░
-
-Sprint 1:
-   Tareas completadas: 12/25 (48%)
-   Horas: 35h/77h completadas
-```
-
-### Todas las tareas Done
-
-```
-✅ Tarea completada!
-
-🔧 TASK-006: Tests AuthService
-   Estado: 🟢 Done
-
-🎉 Todas las tareas de US-001 completadas!
-
-📖 US-001: Inicio de sesión de usuario
-   Progreso: 6/6 (100%) ██████████
-
-Próximo paso recomendado:
-  /sprint:transition US-001 done
-```
-
-### Error de flujo de trabajo
-
-```
-❌ Transición no permitida!
-
-🔧 TASK-004: Controller Auth
-   Estado actual: 🔴 To Do
-   Transición solicitada: → 🟢 Done
-
-Regla: Una tarea debe pasar por "In Progress" antes de "Done"
-
-Acción correcta:
-  /project:move-task TASK-004 in-progress
-  # ... trabajar en la tarea ...
-  /project:move-task TASK-004 done
-```
-
-### Tarea bloqueada
-
-```
-✅ Tarea marcada como bloqueada
-
-🔧 TASK-005: Pantalla Login
-   Estado: 🟡 In Progress → ⏸️ Blocked
-   Bloqueador: Esperando auth API (TASK-003)
-
-Para desbloquear:
-  1. Completar TASK-003
-  2. /project:move-task TASK-005 in-progress
-```
-
-## Ejemplos
-
-```
-# Iniciar una tarea
-/project:move-task TASK-001 in-progress
-
-# Completar una tarea
-/project:move-task TASK-001 done
-
-# Bloquear una tarea
-/project:move-task TASK-001 blocked
-
-# Desbloquear una tarea
-/project:move-task TASK-001 in-progress
-```
-
-## Métricas Actualizadas
-
-En cada movimiento:
-- Conteo de tareas por estado
-- Horas estimadas vs reales
-- Progreso de la US
-- Progreso del Sprint
-- Tablero Kanban
+Ejecuta `/project:backlog move task $ARGUMENTS`: lee `.claude/commands/project/backlog.md` y síguelo con estos argumentos.

package/Project/i18n/es/commands/report.md

@@ -0,0 +1,156 @@
+---
+description: "Informes analíticos del proyecto: burndown del sprint, panel de métricas, grafo de dependencias de historias y ruta crítica"
+argument-hint: "<burndown|metrics|deps> [--critical] [--sprint=Sprint-N] [--type=points|stories|tasks] [--format=...] [--velocity=N] [--output=path]"
+---
+
+# /project:report
+
+## Misión
+
+Punto de entrada único para los análisis del proyecto de solo lectura. Cada subcomando convierte los datos del backlog y del sprint en un informe: un gráfico burndown, un panel de métricas o un grafo de dependencias (con ruta crítica opcional).
+
+## Uso
+
+| Invocación | Qué hace | Reemplaza |
+|------------|----------|-----------|
+| `/project:report burndown` | Gráfico burndown Mermaid + desviación y proyección | `/project:report burndown` |
+| `/project:report metrics` | Panel de velocidad, cobertura de specs, gates, salud y regresión | `/project:report metrics` |
+| `/project:report deps` | Grafo de dependencias de historias, cuellos de botella, grupos paralelos | `/project:report deps` |
+| `/project:report deps --critical` | Ruta crítica, holgura y plan de ejecución en paralelo | `/project:report deps --critical` |
+
+## Argumentos
+
+Analizar `$ARGUMENTS`: la primera palabra posicional es el subcomando (`burndown`, `metrics` o `deps`). Si falta o es desconocido, mostrar la tabla anterior y preguntar cuál ejecutar.
+
+| Opción | Aplica a | Descripción |
+|--------|---------|-------------|
+| `--sprint=Sprint-N` | todos | Sprint a analizar (por defecto: sprint actual) |
+| `--type=points\|stories\|tasks` | burndown | Unidad del gráfico (por defecto `points`) |
+| `--format=dashboard\|json\|markdown` | metrics | Formato de salida (por defecto `dashboard`) |
+| `--format=mermaid\|table\|json` | deps | Formato de salida (por defecto `mermaid`) |
+| `--output=path` | deps | Ruta de salida (por defecto: stdout) |
+| `--critical` | deps | Cambia al análisis de ruta crítica |
+| `--velocity=N` | deps --critical | Velocidad del equipo (puntos por sprint) para estimar el calendario |
+
+## Reglas comunes
+
+- **Fuente única de verdad:** el ESTADO de historias y tareas se lee únicamente de `.bmad/sprint-status.yaml`; los archivos markdown (`project-management/backlog/`, `tasks/TASK-*.md`) aportan el contenido (títulos, puntos, `Depends on:`), nunca el estado. Sus entradas `history` alimentan el burndown y las tendencias de velocidad.
+- Rutas por defecto: `project-management/` (`prd.md`, `backlog/`, `sprints/sprint-{N}-{slug}/`); plantillas en `.claude/templates/project/`.
+- Los informes son de solo lectura sobre los archivos del proyecto; las únicas escrituras son las instantáneas de métricas en `.bmad/metrics/`.
+- **El modo plan es obligatorio:** antes de ejecutar, proponer el plan (datos leídos, archivos escritos) y esperar la validación.
+- Terminar cada informe con las observaciones clave y recomendaciones.
+
+## burndown
+
+Requisitos: `.bmad/sprint-status.yaml` con datos del sprint, fechas de inicio/fin y story points estimados.
+
+1. **Cargar**: leer el sprint actual en `.bmad/sprint-status.yaml` (fechas, puntos comprometidos, `history` de estados por día) y los datos pasados de `.bmad/metrics/`.
+2. **Calcular**: línea ideal (lineal del total a 0), restante real por día, desviación (adelantado/atrasado), fecha de fin proyectada según la velocidad actual.
+3. **Gráfico** (Mermaid):
+
+```mermaid
+xychart-beta
+    title "Sprint-3 Burndown"
+    x-axis ["Day 1", "Day 2", "Day 3", "Day 4", "Day 5", "Day 6", "Day 7", "Day 8", "Day 9", "Day 10"]
+    y-axis "Story Points Remaining" 0 --> 25
+    line "Ideal" [21, 18.9, 16.8, 14.7, 12.6, 10.5, 8.4, 6.3, 4.2, 2.1, 0]
+    line "Actual" [21, 21, 18, 18, 15, 12, 12, 9, 6, 3]
+```
+
+4. **Informe de análisis**:
+
+```
+INFORME BURNDOWN DEL SPRINT — Sprint-3 | Día 9/10
+Total comprometido: 21 pts | Restante: 3 | Completado: 18 (86%)
+Restante ideal: 2.1 | Real: 3 | Desviación: -0.9 pts (ligeramente atrasado)
+Velocidad media: 2.0 pts/día | Fin proyectado: día 10.5 (0.5 días de retraso)
+Tendencia: días 1-3: 3pts (inicio lento) | días 4-6: 6pts | días 7-9: 9pts
+Riesgo: 1 historia puede pasar al siguiente sprint (US-015, 3pts, bloqueada)
+```
+
+5. **Almacenar**: añadir los datos diarios a `.bmad/metrics/burndown-{sprint-id}.json`.
+
+## metrics
+
+Requisitos: `.bmad/sprint-status.yaml`; `project-management/backlog/` con historias; opcionalmente el historial `.bmad/metrics/` y `project-management/prd.md` para la cobertura.
+
+| Categoría | Métricas (fuente) |
+|-----------|-------------------|
+| Velocidad | Puntos completados por sprint, media móvil (últimos 3), ratio de compromiso (completados / comprometidos, objetivo > 80%), arrastre (`sprint-status.yaml`, historial de métricas) |
+| Cobertura de specs | % de FR-xxx cubiertos por historias, % de historias con referencias al código, % de AC con tests, % de cadenas completas FR→US→Code→Test (PRD, historias, `/project:trace`) |
+| Quality gates | Gate PRD (>= 80%), DoD de historias, tasa de éxito sprint ready, tasa de éxito a la primera (historial de gates de `/gate:check`) |
+| Salud del sprint | Historias y tareas terminadas / total, historias bloqueadas, cumplimiento TDD (`sprint-status.yaml`) |
+| Regresión | Bugs encontrados / corregidos por sprint, tasa de regresión, tasa de escape (sesiones QA recette, registro de regresión) |
+
+Proceso:
+1. **Recopilar**: leer `.bmad/sprint-status.yaml`, `.bmad/metrics/`, los datos de trazabilidad (`/project:trace`), el historial de gates y las sesiones QA recette (si existen).
+2. **Calcular**: las cinco categorías y las tendencias respecto al sprint anterior (sube / baja / igual).
+3. **Panel** (una línea por métrica con iconos de estado, umbrales como arriba):
+
+```
+PANEL DE MÉTRICAS DEL PROYECTO — Sprint-3 | 2026-02-19
+VELOCIDAD     Actual 18/21 pts (86%) | Media 19 pts/sprint | Compromiso 86% OK | Arrastre 3 pts
+COBERTURA     Requisitos 12/15 (80%) WARN | Historias con código 8/10 | AC con tests 24/28 (86%) OK | Cadenas completas 7/10 (70%) WARN
+QUALITY GATES PRD 1/1 | DoD historia 6/8 (75%) WARN | Sprint ready 1/1 | A la primera 70% WARN
+SALUD SPRINT  Historias 6/8 | Tareas 22/28 | Bloqueadas 1 (US-015) WARN | Cumplimiento TDD 100%
+REGRESIÓN     Bugs encontrados 4 | corregidos 3 | Regresiones 0 | Escape 0%
+TENDENCIAS    Velocidad +2 pts | Cobertura +10% | A la primera -5% | Bloqueadas igual
+```
+
+4. **Almacenar** la instantánea en `.bmad/metrics/sprint-{id}.json`, con las claves `sprint_id`, `date`, `velocity` (`completed`, `committed`, `ratio`), `coverage` (`requirements`, `stories`, `tests`, `traceability`), `gates` (`prd_pass_rate`, `story_pass_rate`, `sprint_ready_rate`, `first_pass_rate`), `health` (`stories_done`, `stories_total`, `tasks_done`, `tasks_total`, `blocked`, `tdd_compliance`), `regression` (`bugs_found`, `bugs_fixed`, `regressions`, `escape_rate`).
+
+`--format=json` o `markdown` genera los mismos datos en ese formato.
+
+## deps
+
+Requisitos: historias de `project-management/backlog/` con campos `Depends on:`; opcionalmente `.bmad/sprint-status.yaml` (colores de estado) y `project-management/prd.md` (agrupación por epic).
+
+1. **Cargar**: recorrer `project-management/backlog/`, filtrar con `--sprint` si se indica, leer `Depends on:` en la sección Traceability de cada historia y construir la lista de adyacencia. El estado proviene de `.bmad/sprint-status.yaml`.
+2. **Validar**: dependencias circulares (A -> B -> C -> A), referencias a historias inexistentes, autorreferencias. Informar de cada problema.
+3. **Grafo** (Mermaid `graph TD`, por defecto): un `subgraph` por epic (`EPIC-001: Authentication`), nodos `US-001[US-001: Login Page]`, aristas `US-002 --> US-001` (depende de) y colores `classDef` según el estado: `done` #90EE90, `inProgress` #FFD700, `blocked` #FF6B6B, `ready` #87CEEB. `--format=table|json` para otras salidas.
+4. **Analizar**: historias cuello de botella (bloquean 3 o más), historias independientes, cadena de dependencias más larga, grupos paralelos.
+5. **Informe**:
+
+```
+GRAFO DE DEPENDENCIAS — Sprint-3 | Historias: 8 | Dependencias: 5
+Cuellos de botella: US-001 Login Page (bloquea 4 historias)
+Independientes: US-006, US-007
+Cadena más larga (3 pasos): US-001 -> US-002 -> US-003
+Grupos paralelos: [US-006, US-007] | [US-004, US-005] (tras US-001)
+Problemas: sin dependencias circulares, sin referencias faltantes
+```
+
+### deps --critical
+
+Requiere además story points. La ruta crítica es la secuencia más larga de historias dependientes; fija la duración mínima sea cual sea el tamaño del equipo.
+
+1. **Construir el DAG** a partir del grafo anterior (detenerse si hay un ciclo).
+2. **Calcular**: orden topológico, inicio/fin más temprano y más tardío por historia, historias con holgura cero = ruta crítica, puntos acumulados a lo largo de la ruta.
+3. **Holgura**: holgura total de las historias no críticas, rutas casi críticas (holgura < 2 pts), historias que podrían volverse críticas si se retrasan.
+4. **Calendario** (usar `--velocity` para repartir las fases en sprints):
+
+```
+ANÁLISIS DE RUTA CRÍTICA — Sprint-3 | Velocidad: 21 pts/sprint
+Ruta crítica (13 pts): US-001 (5) -> US-002 (3) -> US-005 (5)
+Casi crítica: US-001 (5) -> US-004 (3) [holgura: 2pts]
+Fase 1: US-001 + US-006 + US-007 (8pts) | Fase 2: US-002 + US-004 (6pts) | Fase 3: US-003 + US-005 (7pts)
+Holgura: US-003 5pts | US-004 2pts (vigilar) | US-006, US-007 8pts
+```
+
+5. **Recomendaciones**: orden de ejecución óptimo, paralelización, riesgos en las historias críticas (p. ej. asignar al desarrollador más sólido a US-001), formas de acortar la ruta (dividir historias).
+
+## Ejemplo
+
+```
+User: /project:report deps --critical --sprint=Sprint-3 --velocity=21
+
+Claude: Ruta crítica: US-001 -> US-002 -> US-005 (13 pts), cabe en 1 sprint.
+Riesgo: un retraso de 2 o más días en US-001 pone en peligro todo el sprint.
+```
+
+## Comandos relacionados
+
+- `/project:trace` — Matriz de trazabilidad y cobertura
+- `/workflow:status` — Resumen del estado del sprint
+- `/project:backlog next story` — Siguiente historia (considera las dependencias)
+- `/workflow:retro` — Retrospectiva del sprint (usa las métricas)