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

package/Project/i18n/es/Sprint/commands/auto-route.md

@@ -1,233 +1,9 @@
 ---
-description: Ejecutar las reglas de enrutamiento automatico para las transiciones de stories
-argument-hint: [--dry-run]
+description: "Obsoleto (se elimina en 9.0): usa /project:backlog move story --auto"
+deprecated: true
+replaced-by: /project:backlog
 ---
 
-# Sprint Auto Route
+> ⚠️ `/sprint:auto-route` está obsoleto y se eliminará en 9.0. Usa `/project:backlog move story --auto`.
 
-Ejecutar las reglas de enrutamiento automatico para transicionar las stories en funcion de su estado actual y metricas de completitud.
-
-## Argumentos
-
-$ARGUMENTS (format: [--dry-run])
-- **--dry-run** (opcional): Previsualizar las transiciones sin aplicarlas
-
-## Proceso
-
-### Paso 1: Cargar el estado del sprint
-
-1. Leer `.bmad/sprint-status.yaml`
-2. Cargar las reglas de enrutamiento desde `routing.auto_transitions.rules`
-3. Obtener todas las stories
-
-### Paso 2: Evaluar las reglas
-
-Para cada story, evaluar todas las reglas de enrutamiento:
-
-**Regla: all_tasks_complete**
-```yaml
-when: "tasks.completed == tasks.total && tasks.total > 0"
-from: "in-progress"
-to: "review"
-```
-
-**Regla: review_approved**
-```yaml
-when: "review.approved == true"
-from: "review"
-to: "done"
-```
-
-**Regla: blocked_detection**
-```yaml
-when: "blocked_reason != null"
-from: "*"
-to: "blocked"
-```
-
-**Regla: unblocked**
-```yaml
-when: "blocked_reason == null && previous_status != null"
-from: "blocked"
-to: "previous_status"
-```
-
-### Paso 3: Verificar los prerrequisitos
-
-Antes de la auto-transicion, verificar:
-- Requisitos del gate para el estado destino
-- Sin reglas conflictivas
-- Story no bloqueada manualmente
-
-### Paso 4: Ejecutar las transiciones (excepto --dry-run)
-
-Para cada regla activada:
-1. Registrar la transicion
-2. Actualizar el estado
-3. Registrar en el historial con `by: "auto-route"`
-4. Aplicar los efectos secundarios (fase TDD, etc.)
-
-### Paso 5: Reportar los resultados
-
-Mostrar:
-- Numero de reglas evaluadas
-- Transiciones efectuadas
-- Stories sin cambios
-- Errores o advertencias eventuales
-
-## Formato de salida
-
-### Dry Run
-
-```
-═══════════════════════════════════════════════════════
-           Previsualizacion Auto-Route (DRY RUN)
-═══════════════════════════════════════════════════════
-
-Evaluando 4 reglas de enrutamiento contra 8 stories...
-
-Transicionaria:
-──────────────────────────────────────────────────────
-📖 US-005: Autenticacion de usuario
-   Regla: all_tasks_complete
-   in-progress → review
-   Razon: 5/5 tareas terminadas
-
-📖 US-008: Verificacion de email
-   Regla: all_tasks_complete
-   in-progress → review
-   Razon: 3/3 tareas terminadas
-
-📖 US-003: Integracion OAuth
-   Regla: unblocked
-   blocked → in-progress
-   Razon: blocked_reason eliminado
-
-Resumen:
-──────────────────────────────────────────────────────
-Reglas evaluadas: 4
-Stories verificadas: 8
-Transicionaria: 3
-Sin cambio necesario: 5
-
-Ejecutar sin --dry-run para aplicar las transiciones.
-═══════════════════════════════════════════════════════
-```
-
-### Transiciones aplicadas
-
-```
-═══════════════════════════════════════════════════════
-              Resultados Auto-Route
-═══════════════════════════════════════════════════════
-
-Evaluando 4 reglas de enrutamiento contra 8 stories...
-
-Transiciones aplicadas:
-──────────────────────────────────────────────────────
-✅ US-005: in-progress → review
-   Regla: all_tasks_complete
-   Tareas: 5/5 terminadas
-
-✅ US-008: in-progress → review
-   Regla: all_tasks_complete
-   Tareas: 3/3 terminadas
-
-✅ US-003: blocked → in-progress
-   Regla: unblocked
-   Estado anterior restaurado
-
-Resumen:
-──────────────────────────────────────────────────────
-Reglas evaluadas: 4
-Stories verificadas: 8
-Transicionadas: 3
-Sin cambio necesario: 5
-
-Estado sprint actualizado. Ejecutar /sprint:status --bmad para ver.
-═══════════════════════════════════════════════════════
-```
-
-### Ninguna transicion necesaria
-
-```
-═══════════════════════════════════════════════════════
-              Resultados Auto-Route
-═══════════════════════════════════════════════════════
-
-Evaluando 4 reglas de enrutamiento contra 8 stories...
-
-Ninguna transicion automatica necesaria.
-──────────────────────────────────────────────────────
-Todas las stories estan en estados apropiados segun
-sus metricas de completitud actuales.
-
-Stories por estado:
-  📋 Backlog: 2
-  🎯 Ready: 3
-  🔄 En curso: 2 (tareas pendientes)
-  ✅ Done: 1
-═══════════════════════════════════════════════════════
-```
-
-## Ejemplo
-
-```
-/sprint:auto-route --dry-run
-/sprint:auto-route
-```
-
-## Reglas personalizadas
-
-Agregar reglas personalizadas en `.bmad/sprint-status.yaml`:
-
-```yaml
-routing:
-  auto_transitions:
-    enabled: true
-    rules:
-      # Regla personalizada: story demasiado tiempo en review
-      - name: "review_timeout"
-        description: "Senalar las stories en review > 2 dias"
-        when: "status == 'review' && days_in_status > 2"
-        action: "flag"  # flag | transition | notify
-
-      # Regla personalizada: prioridad alta primero
-      - name: "priority_bump"
-        description: "Auto-asignar las stories de alta prioridad"
-        when: "priority == 'high' && status == 'ready-for-dev'"
-        action: "notify"
-```
-
-## Integracion
-
-El auto-route puede activarse:
-1. Manualmente via este comando
-2. Automaticamente en el hook Stop
-3. Despues de completar una tarea
-4. Al inicio de sesion (configurable)
-
-Configurar en `.bmad/sprint-status.yaml`:
-```yaml
-routing:
-  auto_transitions:
-    enabled: true
-    run_on_session_start: false
-    run_on_task_complete: true
-```
-
-## Siguiente paso
-
-```
-╔══════════════════════════════════════════════════════════╗
-║                    SIGUIENTE PASO                        ║
-╠══════════════════════════════════════════════════════════╣
-║                                                          ║
-║  → /sprint:next-story                                    ║
-║    Tomar la siguiente story enrutada                     ║
-║                                                          ║
-║  → /sprint:dev                                           ║
-║    Iniciar el desarrollo                                 ║
-║                                                          ║
-╚══════════════════════════════════════════════════════════╝
-```
+Ejecuta `/project:backlog move story --auto $ARGUMENTS`: lee `.claude/commands/project/backlog.md` y síguelo con estos argumentos.

package/Project/i18n/es/Sprint/commands/dev.md

@@ -1,445 +1,9 @@
 ---
-name: sprint-dev
-description: Iniciar el desarrollo TDD/BDD de un sprint con actualizaciones automáticas de estado
-arguments:
-  - name: sprint
-    description: Número de sprint, "next" para el siguiente sprint incompleto, o "current"
-    required: true
+description: "Obsoleto (se elimina en 9.0): usa /workflow:implement"
+deprecated: true
+replaced-by: /workflow:implement
 ---
 
-# /sprint:dev
+> ⚠️ `/sprint:dev` está obsoleto y se eliminará en 9.0. Usa `/workflow:implement`.
 
-## Propósito
-
-Orquestar el desarrollo completo de un sprint en modo TDD/BDD con:
-- **Modo plan obligatorio** antes de cada implementación de tarea
-- **Ciclo TDD** (RED → GREEN → REFACTOR)
-- **Actualizaciones automáticas de estado** (Tarea → Historia de Usuario → Sprint)
-- **Seguimiento de progreso** y métricas
-
-## Prerrequisitos
-
-- El sprint existe con tareas descompuestas
-- Archivos presentes: `sprint-backlog.md`, `tasks/*.md`
-- Ejecutar `/project:decompose-tasks N` primero si es necesario
-
-## Argumentos
-
-```bash
-/sprint:dev 1        # Sprint 1
-/sprint:dev next     # Siguiente sprint incompleto
-/sprint:dev current  # Sprint actualmente activo
-```
-
----
-
-## Flujo de Trabajo
-
-### Fase 1: Inicialización
-
-1. Cargar el sprint desde `project-management/sprints/sprint-N-*/`
-2. Leer `sprint-backlog.md` para obtener las Historias de Usuario
-3. Listar tareas por HU (ordenadas por dependencias)
-4. Mostrar el tablero inicial
-
-```
-📋 Sprint 1: Walking Skeleton
-   Objetivo: Completar el flujo de autenticación de extremo a extremo
-
-   3 Historias de Usuario, 17 Tareas
-
-   🔴 Por Hacer: 15 | 🟡 En Progreso: 2 | 🟢 Hecho: 0
-```
-
-### Fase 2: Bucle de Historias de Usuario
-
-Para cada Historia de Usuario en estado Por Hacer o En Progreso:
-
-1. **Marcar HU → En Progreso** (si estaba Por Hacer)
-2. **Mostrar los criterios de aceptación** (formato Gherkin)
-3. **Procesar cada tarea** de esta HU
-
-```
-🎯 HU-001: Autenticación de Usuario (5 pts)
-   Estado: 🟡 En Progreso
-
-   Criterios de Aceptación:
-   ┌─────────────────────────────────────────────────────┐
-   │ DADO un usuario registrado con credenciales válidas │
-   │ CUANDO envía el formulario de inicio de sesión      │
-   │ ENTONCES debería ver su panel de control            │
-   │ Y se debería crear una sesión                       │
-   └─────────────────────────────────────────────────────┘
-
-   Tareas:
-   └─ TAREA-001 [DB] Crear entidad User .............. 🔴 Por Hacer
-   └─ TAREA-002 [BE] Servicio de autenticación ....... 🔴 Por Hacer
-   └─ TAREA-003 [FE-WEB] Formulario de inicio de sesión 🔴 Por Hacer
-   └─ TAREA-004 [TEST] Pruebas E2E de autenticación .. 🔴 Por Hacer
-```
-
-### Fase 3: Bucle de Tareas (Flujo de Trabajo TDD)
-
-Para cada tarea en Por Hacer:
-
-#### 3.1 Mostrar Detalles de la Tarea
-
-```
-▶️ Iniciando TAREA-001 [DB] Crear entidad User
-
-   Estimación: 2h
-   Descripción: Crear entidad User con email, password_hash, roles
-   Archivos a modificar: src/Entity/User.php, migrations/
-
-   Definición de Hecho:
-   - [ ] Código escrito y funcional
-   - [ ] Las pruebas pasan
-   - [ ] Código revisado (si existe tarea [REV])
-```
-
-#### 3.2 Modo Plan (OBLIGATORIO)
-
-⚠️ **SIEMPRE activar el modo plan antes de implementar**
-
-```
-⚠️ MODO PLAN ACTIVADO
-
-   Analizando tarea TAREA-001...
-
-   📁 Archivos a analizar:
-   - src/Entity/ (patrón de entidades existentes)
-   - config/packages/doctrine.yaml
-   - migrations/ (última migración)
-
-   🔍 Análisis en progreso...
-```
-
-El modo plan DEBE:
-1. **Explorar** el código impactado y las dependencias
-2. **Documentar** los hallazgos del análisis
-3. **Proponer** un plan de implementación con:
-   - Archivos a crear/modificar
-   - Pruebas a escribir (TDD)
-   - Riesgos y mitigaciones
-4. **Esperar** la validación del usuario antes de proceder
-
-```
-📋 Plan de Implementación para TAREA-001
-
-   1. Crear entidad User con propiedades:
-      - id (UUID)
-      - email (único)
-      - password_hash
-      - roles (array JSON)
-      - created_at, updated_at
-
-   2. Pruebas a escribir PRIMERO (TDD):
-      - UserTest::test_user_creation()
-      - UserTest::test_email_validation()
-      - UserTest::test_password_hashing()
-
-   3. Archivos a crear:
-      - src/Entity/User.php
-      - tests/Unit/Entity/UserTest.php
-      - migrations/VersionXXX.php
-
-   ⏳ Esperando validación...
-
-   [continue] Proceder con la implementación
-   [skip] Omitir esta tarea
-   [block] Marcar como bloqueada
-   [stop] Detener sprint-dev
-```
-
-#### 3.3 Marcar Tarea → En Progreso
-
-Después de la validación del plan:
-- Actualizar el estado de la tarea a En Progreso
-- Actualizar board.md
-- Actualizar index.md
-
-#### 3.4 Ciclo TDD
-
-```
-🧪 CICLO TDD - TAREA-001
-
-🔴 Fase RED: Escribir pruebas que fallen
-   Creando tests/Unit/Entity/UserTest.php...
-
-   Ejecutando pruebas... FALLIDO (esperado)
-   ✗ test_user_creation
-   ✗ test_email_validation
-   ✗ test_password_hashing
-
-🟢 Fase GREEN: Implementar el código mínimo
-   Creando src/Entity/User.php...
-
-   Ejecutando pruebas... APROBADO
-   ✓ test_user_creation
-   ✓ test_email_validation
-   ✓ test_password_hashing
-
-🔧 Fase REFACTOR: Mejorar la calidad del código
-   - ¿Extraer la validación de email a un ValueObject? [s/n]
-   - ¿Agregar método factory? [s/n]
-
-   Ejecutando pruebas... APROBADO (sin regresión)
-```
-
-#### 3.5 Verificación de la Definición de Hecho
-
-```
-✅ Definición de Hecho - TAREA-001
-
-- [x] Código escrito y funcional
-- [x] Las pruebas pasan (3/3)
-- [ ] Código revisado → Gestionado por TAREA-XXX [REV]
-
-¡Todas las verificaciones superadas!
-```
-
-#### 3.6 Marcar Tarea → Hecho
-
-```
-📊 Finalización de Tarea
-
-TAREA-001 [DB] Crear entidad User
-├─ Estado: 🟢 Hecho
-├─ Estimado: 2h
-├─ Real: 1.5h
-└─ Eficiencia: 133%
-
-Introduzca el tiempo real empleado (horas): 1.5
-```
-
-Actualizaciones:
-- Metadatos del archivo de tarea (estado, time_spent, updated_at)
-- board.md
-- index.md
-- Métricas del sprint
-
-#### 3.7 Commit Convencional
-
-```
-📝 Creando commit...
-
-feat(entity): create User entity with authentication support
-
-- Add User entity with email, password_hash, roles
-- Add UUID primary key strategy
-- Add timestamps (created_at, updated_at)
-- Add unit tests for User entity
-
-Refs: TAREA-001, HU-001
-
-🤖 Generated with [Claude Code](https://claude.com/claude-code)
-
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
-
-### Fase 4: Validación de la Historia de Usuario
-
-Cuando todas las tareas de una HU estén Hechas:
-
-```
-🎯 Validación HU-001
-
-Todas las tareas completadas (4/4)
-
-Verificando criterios de aceptación:
-┌─────────────────────────────────────────────────────┐
-│ ✓ DADO un usuario registrado con credenciales válidas│
-│ ✓ CUANDO envía el formulario de inicio de sesión     │
-│ ✓ ENTONCES debería ver su panel de control           │
-│ ✓ Y se debería crear una sesión                      │
-└─────────────────────────────────────────────────────┘
-
-Ejecutando pruebas E2E si están presentes...
-✓ tests/E2E/AuthenticationTest.php aprobado
-
-HU-001 → 🟢 Hecho
-
-Actualizando progreso de EPIC-001: 1/3 HU completadas (33%)
-```
-
-### Fase 5: Finalización del Sprint
-
-Cuando todas las Historias de Usuario estén Hechas:
-
-```
-🏁 ¡Sprint 1 Completado!
-
-📊 Resumen
-├─ Duración: 8 días (planificado: 10)
-├─ Velocidad: 15 puntos
-├─ Tareas: 17/17 completadas
-└─ Horas: 38h real vs 42h estimado (110% eficiencia)
-
-📈 Métricas por Tipo
-├─ [DB]: 4 tareas, 6h
-├─ [BE]: 5 tareas, 12h
-├─ [FE-WEB]: 4 tareas, 10h
-├─ [TEST]: 3 tareas, 8h
-└─ [DOC]: 1 tarea, 2h
-
-📝 Generando sprint-review.md...
-📝 Generando plantilla sprint-retro.md...
-
-Siguiente: Ejecutar /sprint:dev 2 o /sprint:dev next
-```
-
----
-
-## Orden de Procesamiento de Tareas
-
-Las tareas se procesan por tipo para respetar las dependencias:
-
-| Orden | Tipo | Descripción |
-|-------|------|-------------|
-| 1 | `[DB]` | Base de datos (entidades, migraciones, repositorios) |
-| 2 | `[BE]` | Backend (servicios, APIs, lógica de negocio) |
-| 3 | `[FE-WEB]` | Frontend Web (controladores, plantillas, JS) |
-| 4 | `[FE-MOB]` | Frontend Móvil (pantallas, blocs, widgets) |
-| 5 | `[TEST]` | Pruebas adicionales (E2E, rendimiento) |
-| 6 | `[DOC]` | Documentación |
-| 7 | `[REV]` | Revisión de Código |
-
----
-
-## Comandos de Control
-
-Durante la ejecución de sprint-dev:
-
-| Comando | Acción |
-|---------|--------|
-| `continue` | Validar el plan y proceder con la implementación |
-| `skip` | Omitir esta tarea (permanece Por Hacer) |
-| `block [razón]` | Marcar la tarea como Bloqueada con razón |
-| `stop` | Detener sprint-dev (guarda el estado actual) |
-| `status` | Mostrar el progreso actual |
-| `board` | Mostrar el tablero Kanban |
-
----
-
-## Gestión de Bloqueos
-
-```
-⚠️ Tarea Bloqueada
-
-TAREA-003 no puede continuar.
-Razón: Esperando la especificación de API del equipo de backend
-
-Opciones:
-[1] Omitir y continuar con la siguiente tarea desbloqueada
-[2] Intentar resolver el bloqueo
-[3] Detener sprint-dev
-
-Elección: 1
-
-Marcando TAREA-003 como Bloqueada...
-Pasando a TAREA-004...
-```
-
----
-
-## Actualizaciones Automáticas
-
-En cada cambio de estado:
-
-1. **Archivo de tarea**: Actualizar estado, time_spent, updated_at
-2. **Archivo de Historia de Usuario**: Actualizar progreso de tareas, estado si todas están hechas
-3. **Archivo EPIC**: Actualizar progreso de HU
-4. **board.md**: Actualizar columnas del Kanban
-5. **index.md**: Actualizar métricas globales
-6. **sprint-status**: Recalcular métricas
-
----
-
-## Reanudar Después de Detener
-
-```bash
-/sprint:dev current
-
-📋 Reanudando Sprint 1: Walking Skeleton
-
-Progreso: 8/17 tareas (47%)
-
-Última completada: TAREA-008 [BE] Servicio de Token JWT
-Siguiente tarea: TAREA-009 [FE-WEB] Controlador de Inicio de Sesión
-
-¿Continuar desde TAREA-009? [s/n]
-```
-
----
-
-## Sesión de Ejemplo
-
-```bash
-> /sprint:dev 1
-
-📋 Sprint 1: Walking Skeleton
-   3 HU, 17 tareas
-   🔴 Por Hacer: 17 | 🟡 En Progreso: 0 | 🟢 Hecho: 0
-
-🎯 Iniciando HU-001: Autenticación de Usuario (5 pts)
-   Marcando como En Progreso...
-
-▶️ TAREA-001 [DB] Crear entidad User
-
-⚠️ MODO PLAN ACTIVADO
-   Analizando...
-
-   [Detalles del plan mostrados]
-
-> continue
-
-   Marcando TAREA-001 como En Progreso...
-
-🧪 CICLO TDD
-
-🔴 RED: Escribiendo pruebas...
-   [Código de prueba creado]
-   Pruebas: 0/3 pasando (esperado)
-
-🟢 GREEN: Implementando...
-   [Código de implementación]
-   Pruebas: 3/3 pasando
-
-🔧 REFACTOR: ¿Alguna mejora? [omitir]
-
-✅ Definición de Hecho: APROBADA
-
-   Introduzca el tiempo real (estimado 2h): 1.5
-
-📝 Commit creado: feat(entity): create User entity
-
-▶️ TAREA-002 [BE] Servicio de autenticación
-
-⚠️ MODO PLAN ACTIVADO
-   ...
-```
-
----
-
-## Archivos Actualizados
-
-| Archivo | Actualizaciones |
-|---------|----------------|
-| `project-management/backlog/user-stories/HU-XXX.md` | Estado, progreso de tareas |
-| `project-management/backlog/epics/EPIC-XXX.md` | Progreso de HU |
-| `project-management/sprints/sprint-N-*/board.md` | Columnas del Kanban |
-| `project-management/sprints/sprint-N-*/tasks/*.md` | Estado de tarea, tiempo |
-| `project-management/backlog/index.md` | Métricas globales |
-| `project-management/sprints/sprint-N-*/sprint-review.md` | Generado al final |
-
----
-
-## Comandos Relacionados
-
-| Comando | Uso |
-|---------|-----|
-| `/project:decompose-tasks N` | Crear tareas antes de sprint-dev |
-| `/project:board N` | Ver tablero Kanban |
-| `/sprint:status N` | Ver métricas del sprint |
-| `/project:move-task` | Cambiar manualmente el estado de una tarea |
-| `/sprint:transition` | Cambiar manualmente el estado de una HU |
+Ejecuta `/workflow:implement $ARGUMENTS`: lee `.claude/commands/workflow/implement.md` y síguelo con estos argumentos.