elsabro 2.0.0

package/commands/elsabro/debug.md

@@ -0,0 +1,153 @@
+---
+name: debug
+description: Debugging sistemático para investigar y resolver problemas
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - WebSearch
+  - Task
+  - AskUserQuestion
+  - mcp__plugin_context7_context7__*
+argument-hint: "[descripción del problema]"
+---
+
+# ELSABRO: Debug
+
+<objective>
+Investigar y resolver bugs usando el método científico, no adivinando.
+
+**Argumento opcional:** Descripción del problema. Si no se proporciona, preguntar al usuario.
+</objective>
+
+<process>
+## Paso 1: Entender el Problema
+
+Si no hay descripción, preguntar:
+
+```
+Cuéntame qué está pasando:
+
+1. ¿Qué debería pasar?
+2. ¿Qué pasa en su lugar?
+3. ¿Cuándo empezó el problema?
+4. ¿Cambiaste algo recientemente?
+```
+
+Usar `AskUserQuestion` para esto.
+
+## Paso 2: Crear Sesión de Debug
+
+Crear archivo `.planning/debug/{slug}.md`:
+
+```markdown
+# Debug: [Descripción corta]
+
+## Status: gathering
+
+## Síntomas
+- [Lo que reportó el usuario]
+- [Error exacto si hay]
+- [Cuándo ocurre]
+
+## Ambiente
+- [Proyecto/Framework]
+- [Versiones relevantes]
+```
+
+## Paso 3: Spawnnear Debugger
+
+Usar el Task tool para spawnnear el agente `elsabro-debugger`:
+
+```
+Task(elsabro-debugger):
+  Investiga este bug:
+  [Descripción del problema]
+  [Síntomas observados]
+  [Contexto del proyecto]
+
+  Sigue las 4 fases:
+  1. Investigar root cause
+  2. Analizar patrones
+  3. Formar y testear hipótesis
+  4. Implementar fix (si find_and_fix)
+
+  Modo: find_and_fix
+```
+
+## Paso 4: Seguimiento
+
+El debugger actualizará el archivo de sesión con:
+- Hipótesis investigadas
+- Root cause encontrado
+- Fix implementado
+- Verificación realizada
+
+## Paso 5: Verificar con Usuario
+
+Una vez el debugger reporta fix:
+
+```
+El problema estaba en: [root cause]
+
+Lo arreglé: [descripción del fix]
+
+Para verificar:
+1. [Paso de verificación]
+2. [Paso de verificación]
+
+¿Funciona ahora?
+```
+</process>
+
+<modes>
+## Modos de Debug
+
+### find_root_cause_only
+Solo investiga y reporta la causa. No hace cambios.
+Útil cuando quieres entender antes de decidir.
+
+### find_and_fix (default)
+Investiga, encuentra la causa, e implementa el fix.
+Útil cuando confías en que el debugger lo resuelva.
+</modes>
+
+<user_help>
+## Si el Usuario Necesita Ayuda
+
+Frases activadoras para explicación detallada:
+- "no entiendo"
+- "explícame"
+- "qué significa"
+- "más detalle"
+
+Entonces explicar:
+- Qué es el error en términos simples
+- Por qué ocurre (analogía si ayuda)
+- Qué vamos a hacer para arreglarlo
+</user_help>
+
+<escalation>
+## Escalación
+
+Si después de 3 intentos el bug no se resuelve:
+
+```
+He intentado varias cosas pero el problema persiste.
+
+Lo que sé hasta ahora:
+- [Hallazgo 1]
+- [Hallazgo 2]
+
+Opciones:
+1. Investigar más a fondo (más tiempo)
+2. Buscar ayuda externa (StackOverflow, docs)
+3. Replantear el approach
+4. Trabajar en otra cosa y volver después
+
+¿Qué prefieres?
+```
+</escalation>

package/commands/elsabro/discuss-phase.md

@@ -0,0 +1,160 @@
+---
+name: discuss-phase
+description: Discusión colaborativa sobre una fase - clarificar scope, identificar riesgos, refinar approach
+---
+
+# /elsabro:discuss-phase
+
+<command-name>discuss-phase</command-name>
+
+## Propósito
+
+Facilitar una discusión estructurada sobre una fase para clarificar alcance, identificar riesgos y refinar el approach antes de comenzar la implementación.
+
+## Uso
+
+```bash
+# Discutir fase actual
+/elsabro:discuss-phase
+
+# Discutir fase específica
+/elsabro:discuss-phase P3
+
+# Discutir con foco específico
+/elsabro:discuss-phase P3 --focus=risks
+/elsabro:discuss-phase P3 --focus=scope
+/elsabro:discuss-phase P3 --focus=approach
+```
+
+## Proceso de Discusión
+
+### Paso 1: Context Loading
+
+ELSABRO carga:
+- Definición de la fase
+- Tasks asociados
+- Dependencias
+- Work completado en fases anteriores
+
+### Paso 2: Facilitación
+
+```
+┌──────────────────────────────────────────────────┐
+│  PHASE DISCUSSION: P3 - Frontend                 │
+├──────────────────────────────────────────────────┤
+│                                                  │
+│  Current understanding:                          │
+│  - Build React components for dashboard          │
+│  - Integrate with backend API                    │
+│  - Implement responsive design                   │
+│                                                  │
+│  Key questions:                                  │
+│  1. What's the priority order of components?    │
+│  2. Are there design mockups to follow?         │
+│  3. What's the testing strategy?                │
+│                                                  │
+└──────────────────────────────────────────────────┘
+```
+
+### Paso 3: Discusión Interactiva
+
+```
+ELSABRO: Let's clarify the scope. What components
+         are must-have vs nice-to-have?
+
+User: Dashboard cards and navigation are must-have.
+      Charts can wait for next iteration.
+
+ELSABRO: Got it. Updating scope...
+
+Must-have:
+- Dashboard cards
+- Navigation
+- User profile
+
+Nice-to-have (defer to P4):
+- Charts
+- Advanced filters
+
+Does this look right? (y/n/adjust)
+```
+
+### Paso 4: Documentación
+
+Genera/actualiza `.planning/milestones/M001/P3-DISCUSSION.md`:
+
+```markdown
+# Phase Discussion: P3 - Frontend
+
+## Date: 2024-01-20
+
+## Participants
+- User
+- ELSABRO
+
+## Key Decisions
+
+### Scope
+- **Must-have:** Dashboard cards, navigation, user profile
+- **Deferred:** Charts, advanced filters
+
+### Approach
+- Use existing component library
+- Start with mobile-first
+- TDD for business logic
+
+### Risks Identified
+1. API not finalized - Mitigation: Use mocks
+2. No design specs - Mitigation: Follow existing patterns
+
+### Open Questions
+- [ ] Confirm color palette with design team
+- [ ] Clarify error state designs
+
+## Action Items
+- [ ] Create component inventory
+- [ ] Set up Storybook
+- [ ] Write first component tests
+```
+
+## Temas de Discusión
+
+### Scope Focus
+```bash
+/elsabro:discuss-phase P3 --focus=scope
+```
+- Qué está incluido
+- Qué está fuera de scope
+- Acceptance criteria
+
+### Risks Focus
+```bash
+/elsabro:discuss-phase P3 --focus=risks
+```
+- Technical risks
+- Dependency risks
+- Timeline risks
+- Mitigaciones
+
+### Approach Focus
+```bash
+/elsabro:discuss-phase P3 --focus=approach
+```
+- Cómo implementar
+- Qué tools usar
+- Orden de trabajo
+
+## Output
+
+```
+✓ Discussion complete for P3
+
+  Documented: .planning/milestones/M001/P3-DISCUSSION.md
+
+  Summary:
+  - 3 scope decisions made
+  - 2 risks identified
+  - 5 action items created
+
+  Next: /elsabro:execute to start implementation
+```

package/commands/elsabro/execute.md

@@ -0,0 +1,299 @@
+---
+name: execute
+description: Ejecutar un plan con TDD, verificación automática y commits atómicos
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - mcp__plugin_context7_context7__*
+argument-hint: "[número de fase]"
+---
+
+# ELSABRO: Execute
+
+<objective>
+Ejecutar planes de una fase con:
+- Investigación de patrones con Context7
+- TDD cuando sea apropiado
+- Commits atómicos por tarea
+- Verificación automática
+</objective>
+
+<process>
+## Paso 1: Descubrir Planes
+
+```bash
+ls .planning/*-PLAN.md
+```
+
+Encontrar planes para la fase especificada.
+
+## Paso 2: Organizar por Waves
+
+Leer frontmatter de cada plan para agrupar por `wave`:
+
+```
+Wave 1: [Planes que pueden correr en paralelo]
+Wave 2: [Planes que dependen de Wave 1]
+Wave 3: [Planes que dependen de Wave 2]
+```
+
+## Paso 3: Ejecutar Waves
+
+Para cada wave:
+
+### Si hay múltiples planes en la wave → Paralelo
+```
+Task(elsabro-executor) para Plan 1 |
+Task(elsabro-executor) para Plan 2 |
+Task(elsabro-executor) para Plan 3
+```
+
+### Si solo hay un plan → Secuencial
+```
+Task(elsabro-executor) para Plan único
+```
+
+Cada executor recibe:
+- El PLAN.md completo
+- Referencias a RESEARCH.md
+- Instrucciones de TDD
+- Instrucciones de commits
+
+## Paso 4: Verificar Fase
+
+Una vez todos los planes completados:
+
+```
+Task(elsabro-verifier):
+  Verifica la fase [N]:
+  - Lee los SUMMARY.md generados
+  - Verifica must_haves de cada plan
+  - Genera VERIFICATION.md
+```
+
+## Paso 5: Manejar Resultados
+
+### Si passed:
+```
+✓ Fase [N] completada
+
+Lo que se hizo:
+- [Resumen de tareas]
+
+Archivos modificados:
+- [Lista de archivos]
+
+Commits creados:
+- [Lista de commits]
+
+¿Siguiente paso?
+- Continuar con fase [N+1]: /elsabro:plan [N+1]
+- Verificar manualmente: /elsabro:verify [N]
+```
+
+### Si gaps_found:
+```
+⚠ Fase [N] tiene gaps
+
+Problemas encontrados:
+- [Gap 1]
+- [Gap 2]
+
+Opciones:
+1. Crear planes de corrección: /elsabro:plan [N] --gaps
+2. Ver detalles: cat .planning/[N]-VERIFICATION.md
+3. Continuar de todas formas
+```
+
+### Si human_needed:
+```
+👤 Se necesita verificación manual
+
+Por favor prueba:
+1. [Instrucción]
+2. [Instrucción]
+
+Cuando termines, dime si funcionó o qué problemas encontraste.
+```
+</process>
+
+<execution_protocol>
+## Protocolo de Ejecución
+
+### Para Cada Tarea
+
+1. **¿Necesita Context7?**
+   - Si usa librería específica → Verificar patrón actual
+
+2. **¿Es candidata para TDD?**
+   - Lógica de negocio → SÍ
+   - Endpoints API → SÍ
+   - Configuración → NO
+   - UI simple → NO
+
+3. **Si TDD:**
+   ```
+   a. Escribir test que falla
+   b. Verificar que falla por razón correcta
+   c. Implementar código mínimo
+   d. Verificar que test pasa
+   e. Refactorizar si necesario
+   f. Commit
+   ```
+
+4. **Si no TDD:**
+   ```
+   a. Implementar código
+   b. Ejecutar <verify>
+   c. Confirmar resultado esperado
+   d. Commit
+   ```
+
+### Commit por Tarea
+
+```bash
+git add [archivos]
+git commit -m "feat([fase]-[plan]): [descripción]"
+```
+</execution_protocol>
+
+<parallel_execution>
+## Ejecución Paralela
+
+### Cuándo usar paralelo
+- Múltiples planes en la misma wave
+- Tareas independientes (sin dependencias)
+
+### Cómo paralelizar
+```
+# En un solo mensaje con múltiples Task calls:
+Task(elsabro-executor) Plan 1
+Task(elsabro-executor) Plan 2
+Task(elsabro-executor) Plan 3
+```
+
+### Cuándo NO paralelizar
+- Planes con dependencias entre sí
+- Plan 2 necesita output de Plan 1
+- Modifican los mismos archivos
+</parallel_execution>
+
+<error_handling>
+## Manejo de Errores
+
+### Política de Ejecución Paralela
+
+Este comando usa **policy: quorum** por defecto.
+
+```
+┌────────────────────────────────────────────────┐
+│  PARALLEL EXECUTION POLICY: quorum             │
+├────────────────────────────────────────────────┤
+│  Si >50% de agentes tienen éxito → continuar  │
+│  Si ≤50% de agentes fallan → STOP             │
+└────────────────────────────────────────────────┘
+```
+
+### Clasificación de Errores
+
+| Severity | Emoji | Acción |
+|----------|-------|--------|
+| 🔴 CRITICAL | Parar | No puede continuar de ninguna forma |
+| 🟠 HIGH | Preguntar | Ofrecer opciones: fix/skip/abort |
+| 🟡 MEDIUM | Warning | Mostrar y continuar |
+| ⬜ LOW | Info | Log y continuar |
+
+### Si una tarea falla
+
+```
+1. CLASIFICAR ERROR:
+   - Tests fallan → HIGH
+   - Build falla → HIGH
+   - Dependencia falta → HIGH (auto-fixable)
+   - Lint warnings → MEDIUM
+   - File not found crítico → CRITICAL
+
+2. APLICAR RETRY (si es transitorio):
+   - Attempt 1: Ejecutar
+   - Attempt 2: Esperar 1s, reintentar
+   - Attempt 3: Esperar 2s, reintentar
+   - Máximo 3 intentos, timeout total 2 min
+
+3. SI RETRY FALLA → Escalar según severidad
+
+4. MOSTRAR ERROR formateado:
+   ╔══════════════════════════════════════════╗
+   ║  🟠 ERROR: TESTS_FAILED                  ║
+   ║  Severity: HIGH                          ║
+   ╠══════════════════════════════════════════╣
+   ║  [Detalles del error]                    ║
+   ╠══════════════════════════════════════════╣
+   ║  [d] Debug   [s] Skip   [a] Abort        ║
+   ╚══════════════════════════════════════════╝
+```
+
+### Reglas de Desviación
+
+| Situación | Severity | Acción |
+|-----------|----------|--------|
+| Bug que impide continuar | HIGH | Auto-fix (3 intentos) |
+| Falta validación crítica | HIGH | Auto-add |
+| Falta dependencia | HIGH | Auto-install |
+| Cambio arquitectónico | HIGH | CHECKPOINT |
+| Tests fallan | HIGH | Debug o skip |
+| Lint warnings | MEDIUM | Continuar |
+
+### Actualizar Estado
+
+Después de errores, actualizar `.planning/SESSION-STATE.json`:
+
+```json
+{
+  "errors": {
+    "count": 1,
+    "lastError": {
+      "code": "TESTS_FAILED",
+      "severity": "HIGH",
+      "at": "2024-01-20T15:25:00Z",
+      "resolved": false
+    }
+  },
+  "retry": {
+    "currentAttempt": 3,
+    "maxAttempts": 3,
+    "exhausted": true
+  }
+}
+```
+</error_handling>
+
+<summary_creation>
+## Creación de Summary
+
+Al completar un plan:
+
+```markdown
+# Summary: [Nombre del Plan]
+
+## Completado
+- [x] Tarea 1
+- [x] Tarea 2
+
+## Archivos
+- path/to/file.ts
+- path/to/another.ts
+
+## Commits
+- abc1234: feat(01-01): [descripción]
+- def5678: feat(01-01): [descripción]
+
+## Verificación
+- [x] Build: npm run build
+- [x] Tests: npm run test
+```
+</summary_creation>

package/commands/elsabro/help.md

@@ -0,0 +1,102 @@
+---
+name: help
+description: Muestra todos los comandos disponibles de ELSABRO
+allowed-tools:
+  - Read
+---
+
+# ELSABRO: Ayuda
+
+<output>
+Muestra el siguiente mensaje de ayuda:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+                    ELSABRO v2.0
+           Tu asistente AI para crear apps
+           Powered by BMAD-METHOD + Superpowers
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+GETTING STARTED
+───────────────
+/elsabro:start         Wizard para empezar (recomendado)
+/elsabro:new           Crear un proyecto nuevo
+/elsabro:help          Esta ayuda
+
+CORE WORKFLOW
+─────────────
+/elsabro:plan          Planificar una fase o feature
+/elsabro:execute       Ejecutar un plan
+/elsabro:verify        Verificar que todo funciona
+/elsabro:verify-work   Verificación completa con agentes paralelos
+/elsabro:quick         Ejecución rápida (YOLO mode)
+
+MILESTONE MANAGEMENT
+────────────────────
+/elsabro:new-milestone      Crear nuevo milestone
+/elsabro:complete-milestone Cerrar milestone completado
+/elsabro:audit-milestone    Auditar estado de milestone
+/elsabro:plan-milestone-gaps Planificar gaps en milestone
+
+PHASE MANAGEMENT
+────────────────
+/elsabro:add-phase              Agregar fase al final
+/elsabro:insert-phase           Insertar fase en posición
+/elsabro:remove-phase           Eliminar fase
+/elsabro:discuss-phase          Discutir scope de fase
+/elsabro:research-phase         Investigar tecnologías para fase
+/elsabro:list-phase-assumptions Listar asunciones de fase
+
+SESSION MANAGEMENT
+──────────────────
+/elsabro:resume-work   Retomar trabajo guardado
+/elsabro:pause-work    Pausar y guardar contexto
+/elsabro:progress      Ver progreso actual
+
+TODO MANAGEMENT
+───────────────
+/elsabro:add-todo      Agregar item al todo list
+/elsabro:check-todos   Ver y gestionar todos
+
+DEBUGGING & ANALYSIS
+────────────────────
+/elsabro:debug         Investigar y arreglar problemas
+/elsabro:map-codebase  Generar mapa del codebase
+
+SETTINGS
+────────
+/elsabro:settings      Ver/modificar configuración
+/elsabro:set-profile   Cambiar perfil (default/yolo/careful)
+/elsabro:update        Actualizar ELSABRO
+
+AGENTES DISPONIBLES
+───────────────────
+• elsabro-analyst    - Análisis y research
+• elsabro-planner    - Planificación técnica
+• elsabro-executor   - Implementación de código
+• elsabro-debugger   - Debugging sistemático
+• elsabro-verifier   - Verificación de calidad
+• elsabro-orchestrator - Coordinación de agentes paralelos
+• elsabro-scrum-master - Gestión de sprints
+• elsabro-qa         - Testing y calidad
+• elsabro-ux-designer - Diseño de experiencia
+• elsabro-tech-writer - Documentación
+• elsabro-quick-dev   - Desarrollo rápido (Barry)
+• elsabro-yolo-dev    - Desarrollo ultra-rápido (Flash)
+
+PERFILES
+────────
+• default  - Balance entre velocidad y calidad
+• yolo ⚡   - Máxima velocidad, mínima fricción
+• careful 🛡️ - Máxima calidad, validación exhaustiva
+
+TIPS
+────
+• Si no sabes por dónde empezar → /elsabro:start
+• Para fixes rápidos → /elsabro:quick
+• Para retomar trabajo → /elsabro:resume-work
+• Para cambiar modo → /elsabro:set-profile yolo
+
+¿Algo no quedó claro? Solo pregúntame.
+```
+</output>