@the-bearded-bear/claude-craft 8.8.1 → 8.8.2

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

@@ -1,25 +1,25 @@
 ---
 name: sprint-dev
-description: Inicia el desarrollo TDD/BDD de un sprint con actualizacion automatica de estados
+description: Iniciar el desarrollo TDD/BDD de un sprint con actualizaciones automáticas de estado
 arguments:
   - name: sprint
-    description: Numero de sprint, "next" para el proximo incompleto, o "current"
+    description: Número de sprint, "next" para el siguiente sprint incompleto, o "current"
     required: true
 ---
 
 # /sprint:dev
 
-## Objetivo
+## Propósito
 
 Orquestar el desarrollo completo de un sprint en modo TDD/BDD con:
-- **Plan mode obligatorio** antes de cada implementacion
+- **Modo plan obligatorio** antes de cada implementación de tarea
 - **Ciclo TDD** (RED → GREEN → REFACTOR)
-- **Actualizacion automatica** de estados (Tarea → User Story → Sprint)
-- **Seguimiento de progreso** y metricas
+- **Actualizaciones automáticas de estado** (Tarea → Historia de Usuario → Sprint)
+- **Seguimiento de progreso** y métricas
 
 ## Prerrequisitos
 
-- Sprint existente con tareas descompuestas
+- El sprint existe con tareas descompuestas
 - Archivos presentes: `sprint-backlog.md`, `tasks/*.md`
 - Ejecutar `/project:decompose-tasks N` primero si es necesario
 
@@ -27,168 +27,419 @@ Orquestar el desarrollo completo de un sprint en modo TDD/BDD con:
 
 ```bash
 /sprint:dev 1        # Sprint 1
-/sprint:dev next     # Proximo sprint incompleto
+/sprint:dev next     # Siguiente sprint incompleto
 /sprint:dev current  # Sprint actualmente activo
 ```
 
 ---
 
-## Workflow
+## Flujo de Trabajo
 
-### Fase 1: Inicializacion
+### Fase 1: Inicialización
 
-1. Cargar sprint desde `project-management/sprints/sprint-N-*/`
-2. Leer `sprint-backlog.md` para obtener User Stories
-3. Listar tareas por US (ordenadas por dependencias)
-4. Mostrar board inicial
+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
 
-### Fase 2: Bucle User Story
+```
+📋 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
 
-Para cada US en estado To Do o In Progress:
-1. Marcar US → In Progress
-2. Mostrar criterios de aceptacion (Gherkin)
-3. Procesar cada tarea de la US
+- [x] Código escrito y funcional
+- [x] Las pruebas pasan (3/3)
+- [ ] Código revisado → Gestionado por TAREA-XXX [REV]
 
-### Fase 3: Bucle Tarea (Workflow TDD)
+¡Todas las verificaciones superadas!
+```
+
+#### 3.6 Marcar Tarea → Hecho
 
-Para cada tarea en To Do:
+```
+📊 Finalización de Tarea
 
-#### 3.1 Plan Mode (OBLIGATORIO)
+TAREA-001 [DB] Crear entidad User
+├─ Estado: 🟢 Hecho
+├─ Estimado: 2h
+├─ Real: 1.5h
+└─ Eficiencia: 133%
 
-⚠️ **SIEMPRE activar plan mode antes de implementar**
+Introduzca el tiempo real empleado (horas): 1.5
+```
 
-- Explorar codigo impactado
-- Documentar analisis
-- Proponer plan de implementacion
-- Esperar validacion del usuario
+Actualizaciones:
+- Metadatos del archivo de tarea (estado, time_spent, updated_at)
+- board.md
+- index.md
+- Métricas del sprint
 
-#### 3.2 Ciclo TDD
+#### 3.7 Commit Convencional
 
 ```
-🔴 RED    : Escribir tests que fallan
-🟢 GREEN  : Implementar codigo minimo
-🔧 REFACTOR : Mejorar sin romper tests
+📝 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>
 ```
 
-#### 3.3 Definition of Done
+### Fase 4: Validación de la Historia de Usuario
 
-- [ ] Codigo escrito y funcional
-- [ ] Tests pasan
-- [ ] Codigo revisado (si existe tarea [REV])
+Cuando todas las tareas de una HU estén Hechas:
 
-#### 3.4 Marcar Tarea → Done
+```
+🎯 Validación HU-001
+
+Todas las tareas completadas (4/4)
 
-- Actualizar metadatos
-- Commit convencional
-- Actualizar board
+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                      │
+└─────────────────────────────────────────────────────┘
 
-### Fase 4: Validacion US
+Ejecutando pruebas E2E si están presentes...
+✓ tests/E2E/AuthenticationTest.php aprobado
 
-Cuando todas las tareas de una US estan Done:
-- Verificar criterios de aceptacion
-- Ejecutar tests E2E
-- Marcar US → Done
+HU-001 → 🟢 Hecho
 
-### Fase 5: Cierre Sprint
+Actualizando progreso de EPIC-001: 1/3 HU completadas (33%)
+```
 
-Cuando todas las US estan Done:
-- Mostrar resumen
-- Generar sprint-review.md
-- Generar sprint-retro.md
+### 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
+## Orden de Procesamiento de Tareas
+
+Las tareas se procesan por tipo para respetar las dependencias:
 
-| Orden | Tipo | Descripcion |
+| Orden | Tipo | Descripción |
 |-------|------|-------------|
-| 1 | `[DB]` | Base de datos |
-| 2 | `[BE]` | Backend |
-| 3 | `[FE-WEB]` | Frontend Web |
-| 4 | `[FE-MOB]` | Frontend Mobile |
-| 5 | `[TEST]` | Tests adicionales |
-| 6 | `[DOC]` | Documentacion |
-| 7 | `[REV]` | Code Review |
+| 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
 
-| Comando | Accion |
+Durante la ejecución de sprint-dev:
+
+| Comando | Acción |
 |---------|--------|
-| `continue` | Validar plan y proceder |
-| `skip` | Saltar esta tarea |
-| `block [razon]` | Marcar como bloqueada |
-| `stop` | Detener sprint-dev |
-| `status` | Mostrar progreso |
-| `board` | Mostrar Kanban |
+| `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 |
 
 ---
 
-## Gestion de Bloqueos
+## Gestión de Bloqueos
 
 ```
 ⚠️ Tarea Bloqueada
 
-TASK-003 no puede continuar.
-Razon: Esperando especificaciones API
+TAREA-003 no puede continuar.
+Razón: Esperando la especificación de API del equipo de backend
 
 Opciones:
-[1] Saltar y continuar con siguiente tarea
+[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 Automaticas
+## 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
 
-A cada cambio de estado:
-1. Archivo tarea: status, time_spent
-2. Archivo US: progreso tareas
-3. Archivo EPIC: progreso US
-4. board.md: columnas Kanban
-5. index.md: metricas globales
+```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]
+```
 
 ---
 
-## Ejemplo
+## Sesión de Ejemplo
 
 ```bash
 > /sprint:dev 1
 
 📋 Sprint 1: Walking Skeleton
-   3 US, 17 tareas
+   3 HU, 17 tareas
+   🔴 Por Hacer: 17 | 🟡 En Progreso: 0 | 🟢 Hecho: 0
 
-🎯 Iniciando US-001: Autenticacion (5 pts)
+🎯 Iniciando HU-001: Autenticación de Usuario (5 pts)
+   Marcando como En Progreso...
 
-▶️ TASK-001 [DB] Crear entidad User
+▶️ TAREA-001 [DB] Crear entidad User
 
-⚠️ PLAN MODE ACTIVADO
+⚠️ MODO PLAN ACTIVADO
    Analizando...
 
+   [Detalles del plan mostrados]
+
 > continue
 
+   Marcando TAREA-001 como En Progreso...
+
 🧪 CICLO TDD
-🔴 RED: Escribiendo tests...
+
+🔴 RED: Escribiendo pruebas...
+   [Código de prueba creado]
+   Pruebas: 0/3 pasando (esperado)
+
 🟢 GREEN: Implementando...
-🔧 REFACTOR: Mejoras?
+   [Código de implementación]
+   Pruebas: 3/3 pasando
+
+🔧 REFACTOR: ¿Alguna mejora? [omitir]
+
+✅ Definición de Hecho: APROBADA
 
-✅ Definition of Done: PASADO
+   Introduzca el tiempo real (estimado 2h): 1.5
 
-📝 Commit creado
+📝 Commit creado: feat(entity): create User entity
 
-▶️ TASK-002 [BE] Servicio autenticacion...
+▶️ 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 |
-| `/project:board N` | Ver Kanban |
-| `/sprint:status N` | Ver metricas |
-| `/project:move-task` | Cambiar estado tarea |
-| `/sprint:transition` | Cambiar estado US |
+| `/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 |