elsabro 2.0.0

package/commands/elsabro/pause-work.md

@@ -0,0 +1,261 @@
+---
+name: pause-work
+description: Pausar trabajo guardando contexto para retomar después
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+# /elsabro:pause-work
+
+<command-name>pause-work</command-name>
+
+## Propósito
+
+Guardar el estado actual del trabajo para poder retomarlo fácilmente después. Captura contexto, notas y próximos pasos.
+
+## Uso
+
+```bash
+# Pausar trabajo actual
+/elsabro:pause-work
+
+# Pausar con nota
+/elsabro:pause-work --note="Waiting for API changes"
+
+# Pausar con estimación de regreso
+/elsabro:pause-work --return="tomorrow"
+```
+
+## Proceso de Pausa
+
+### Paso 1: Capturar Estado
+
+```
+Capturing session state...
+
+Current work:
+- Task: User profile page
+- Progress: 60% complete
+- Branch: feature/frontend-dashboard
+
+Files modified:
+- src/components/Profile.tsx (changed)
+- src/hooks/useProfile.ts (new)
+- src/tests/Profile.test.ts (new)
+```
+
+### Paso 2: Solicitar Notas
+
+```
+Add context for when you return:
+
+What were you working on?
+> Implementing profile validation with Zod
+
+What's the next step?
+> Add avatar upload functionality
+
+Any blockers or questions?
+> Need to confirm max file size with product
+
+Estimated return time? (optional)
+> tomorrow morning
+```
+
+### Paso 3: Guardar Sesión
+
+Crea/actualiza `.planning/SESSION.md`:
+
+```markdown
+# Session State
+
+## Paused: 2024-01-20 17:30
+## Expected Return: 2024-01-21 morning
+
+## Current Context
+
+### Active Milestone
+M001 - MVP Launch
+
+### Active Phase
+P3 - Frontend (65% complete)
+
+### Active Task
+User profile page - validation implementation
+
+### Progress Made This Session
+- ✅ Created Profile component structure
+- ✅ Added useProfile hook
+- ✅ Started Zod schema
+- 🟡 Validation integration (in progress)
+
+## Where I Stopped
+
+### File
+`src/components/Profile.tsx:45`
+
+### Last Action
+Adding form validation with Zod
+
+### Next Steps
+1. Complete validation schema
+2. Add avatar upload
+3. Handle server-side email uniqueness
+
+## Notes
+
+### Implementation Notes
+- Using Zod for validation
+- Avatar upload will use presigned URLs
+- Email uniqueness checked via API
+
+### Open Questions
+- [ ] Max avatar file size? (ask product)
+- [ ] Supported image formats?
+
+### Blockers
+- None
+
+## Git State
+
+### Branch
+feature/frontend-dashboard
+
+### Uncommitted Files
+- src/components/Profile.tsx
+- src/hooks/useProfile.ts
+- src/tests/Profile.test.ts
+
+### Recommendation
+Consider committing WIP before extended pause
+```
+
+### Paso 4: Sugerir Commit
+
+```
+You have 3 uncommitted files.
+
+Options:
+1. Commit WIP now (recommended for long pause)
+2. Stash changes
+3. Leave as-is (for short pause)
+
+Choice (1/2/3):
+```
+
+## Opciones
+
+```bash
+--note, -n         # Add context note
+--return, -r       # Expected return time
+--commit           # Auto-commit WIP
+--stash            # Stash changes
+--no-prompt        # Skip interactive prompts
+```
+
+## Output
+
+```
+╔══════════════════════════════════════════════════╗
+║  SESSION PAUSED                                  ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  Saved: .planning/SESSION.md                     ║
+║  Task: User profile page                         ║
+║  Progress: 60%                                   ║
+║  Return: Tomorrow morning                        ║
+║                                                  ║
+║  3 uncommitted files (consider committing)       ║
+║                                                  ║
+╠══════════════════════════════════════════════════╣
+║  To resume: /elsabro:resume-work                 ║
+╚══════════════════════════════════════════════════╝
+```
+
+## Integración
+
+- Paired con `/elsabro:resume-work`
+- Optional git integration (commit/stash)
+- Session file tracked in `.planning/`
+
+<session_state_management>
+## Gestión de Estado de Sesión
+
+### Archivos Generados
+
+Al pausar, se crean/actualizan dos archivos:
+
+**1. `.planning/SESSION.md`** - Legible por humanos
+```markdown
+# Session State
+## Paused: [timestamp]
+## Expected Return: [time]
+...
+```
+
+**2. `.planning/SESSION-STATE.json`** - Procesable por agentes
+```json
+{
+  "version": "1.0",
+  "createdAt": "2024-01-20T17:30:00Z",
+  "lastUpdated": "2024-01-20T17:30:00Z",
+  "status": "paused",
+  "context": {
+    "milestone": "M001",
+    "phase": "P3",
+    "progress": 65,
+    "currentTask": "User profile page"
+  },
+  "checkpoints": [...],
+  "git": {
+    "branch": "feature/frontend-dashboard",
+    "lastCommit": "abc1234",
+    "uncommittedFiles": 3
+  },
+  "errors": { "count": 0 },
+  "recovery": {
+    "lastSuccessfulStep": "validation-implementation",
+    "resumeFrom": "avatar-upload",
+    "notes": "Zod schema completo, falta avatar"
+  }
+}
+```
+
+### Validación Antes de Pausar
+
+```
+Checklist pre-pausa:
+- [ ] ¿Hay errores HIGH sin resolver? → Advertir
+- [ ] ¿Hay archivos sin commit? → Sugerir commit/stash
+- [ ] ¿El último commit tiene tests pasando? → Verificar
+```
+
+### Detección de Staleness
+
+Al reanudar, verificar tiempo desde pausa:
+
+| Tiempo | Acción |
+|--------|--------|
+| < 7 días | Continuar normal |
+| 7-30 días | 🟡 Warning: Verificar contexto sigue válido |
+| > 30 días | 🟠 Sugerir revisar milestone completo |
+
+```
+┌──────────────────────────────────────────────────┐
+│  🟡 WARNING: SESSION_STALE                       │
+├──────────────────────────────────────────────────┤
+│  Última actividad: hace 12 días                  │
+│                                                  │
+│  Recomendación: Verificar que el contexto       │
+│  sigue siendo válido antes de continuar.        │
+│                                                  │
+│  Opciones:                                       │
+│  [c] Continuar de todas formas                  │
+│  [r] Revisar milestone primero                  │
+│  [s] Start fresh                                │
+└──────────────────────────────────────────────────┘
+```
+</session_state_management>

package/commands/elsabro/plan-milestone-gaps.md

@@ -0,0 +1,129 @@
+---
+name: plan-milestone-gaps
+description: Identificar y planificar cómo cerrar gaps en un milestone para alcanzar los objetivos
+---
+
+# /elsabro:plan-milestone-gaps
+
+<command-name>plan-milestone-gaps</command-name>
+
+## Propósito
+
+Analizar qué falta para completar un milestone y generar un plan actionable para cerrar los gaps.
+
+## Proceso
+
+### Paso 1: Identificar Gaps
+
+```bash
+/elsabro:plan-milestone-gaps M001
+```
+
+ELSABRO analiza:
+- Success criteria no cumplidos
+- Fases incompletas
+- Tests faltantes
+- Documentación pendiente
+
+### Paso 2: Categorizar Gaps
+
+```markdown
+## Gap Analysis: M001
+
+### Critical Gaps 🔴
+| Gap | Impact | Effort | Priority |
+|-----|--------|--------|----------|
+| Missing auth tests | Blocks deploy | 4h | P0 |
+| API error handling | User impact | 8h | P0 |
+
+### Important Gaps 🟡
+| Gap | Impact | Effort | Priority |
+|-----|--------|--------|----------|
+| Dashboard polish | UX quality | 4h | P1 |
+| Loading states | UX quality | 2h | P1 |
+
+### Nice-to-have ⬜
+| Gap | Impact | Effort | Priority |
+|-----|--------|--------|----------|
+| Dark mode | Enhancement | 8h | P2 |
+```
+
+### Paso 3: Generar Plan
+
+```markdown
+## Gap Closure Plan
+
+### Sprint 1 (This Week)
+Focus: Critical gaps
+
+- [ ] Day 1-2: Auth tests
+  - Write unit tests for auth service
+  - Write integration tests for login flow
+
+- [ ] Day 3-4: API error handling
+  - Add error middleware
+  - Add user-friendly error messages
+  - Add error logging
+
+### Sprint 2 (Next Week)
+Focus: Important gaps
+
+- [ ] Day 1: Dashboard polish
+- [ ] Day 2: Loading states
+
+### Deferred (Post-milestone)
+- Dark mode (move to M002)
+```
+
+## Output
+
+Genera `.planning/milestones/M001-xxx/GAP-PLAN.md` con:
+
+1. **Gap Inventory** - Lista completa de gaps
+2. **Prioritization** - Ordenados por impacto/effort
+3. **Closure Plan** - Plan día a día
+4. **Resource Needs** - Qué se necesita
+5. **Timeline** - Cuándo estará listo
+
+## Opciones
+
+```bash
+# Plan gaps para milestone
+/elsabro:plan-milestone-gaps M001
+
+# Solo mostrar gaps (sin plan)
+/elsabro:plan-milestone-gaps M001 --analyze-only
+
+# Focalizarse en tipo específico
+/elsabro:plan-milestone-gaps M001 --focus=tests
+/elsabro:plan-milestone-gaps M001 --focus=docs
+
+# Con constraint de tiempo
+/elsabro:plan-milestone-gaps M001 --deadline=2024-02-01
+```
+
+## Visualización
+
+```
+╔══════════════════════════════════════════════╗
+║  GAP ANALYSIS: M001 - MVP Launch             ║
+╠══════════════════════════════════════════════╣
+║                                              ║
+║  Current Progress: ████████░░░░ 65%          ║
+║  Gap to Close:     ░░░░████░░░░ 35%          ║
+║                                              ║
+║  Critical:  2 gaps (12h effort)              ║
+║  Important: 2 gaps (6h effort)               ║
+║  Optional:  1 gap  (8h effort)               ║
+║                                              ║
+║  Estimated completion: +3 days               ║
+║  With optional: +5 days                      ║
+║                                              ║
+╚══════════════════════════════════════════════╝
+```
+
+## Integración
+
+- Alimenta sprint planning
+- Conecta con `/elsabro:plan` para detalles
+- Usa `/elsabro:quick` para gaps pequeños

package/commands/elsabro/plan.md

@@ -0,0 +1,272 @@
+---
+name: plan
+description: Planificar una fase o feature con investigación previa
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - WebSearch
+  - mcp__plugin_context7_context7__*
+argument-hint: "[número de fase o descripción de feature]"
+---
+
+# ELSABRO: Plan
+
+<objective>
+Crear un plan ejecutable para una fase o feature, con investigación previa usando Context7 y WebSearch.
+</objective>
+
+<process>
+## Paso 1: Entender Qué Planificar
+
+Si hay argumento numérico → Planificar fase del ROADMAP.md
+Si hay descripción → Planificar feature ad-hoc
+Si no hay argumento → Preguntar qué planificar
+
+## Paso 2: Verificar Contexto
+
+```bash
+# Verificar que existe .planning/
+ls -la .planning/
+```
+
+Si no existe → Sugerir `/elsabro:new` primero.
+
+## Paso 3: Cargar Contexto Relevante
+
+Leer:
+- `.planning/PROJECT.md` (siempre)
+- `.planning/REQUIREMENTS.md` (si existe)
+- `.planning/ROADMAP.md` (si planificando fase)
+- `.planning/config.json` (para preferencias)
+
+## Paso 4: Research-Before-Plan
+
+**OBLIGATORIO:** Investigar antes de planificar.
+
+Spawn agentes en paralelo:
+
+```
+Task(elsabro-planner, model: sonnet):
+  Fase/Feature: [descripción]
+
+  Contexto del proyecto:
+  [Resumen de PROJECT.md]
+
+  Tu trabajo:
+  1. Identificar tecnologías necesarias
+  2. Buscar en Context7 las APIs actuales
+  3. Buscar en WebSearch mejores prácticas [año]
+  4. Crear RESEARCH.md con hallazgos
+  5. Crear PLAN.md con tareas específicas
+
+  Recuerda:
+  - Context7 PRIMERO para cualquier librería
+  - Máximo 2-3 tareas por plan
+  - Cada tarea debe ser verificable
+```
+
+## Paso 5: Crear Archivos
+
+El planner crea:
+- `.planning/{phase}-RESEARCH.md`
+- `.planning/{phase}-{N}-PLAN.md`
+
+## Paso 6: Verificar Plan (Opcional)
+
+Si `plan_check: true` en config.json:
+
+```
+Task(elsabro-verifier, model: haiku):
+  Verifica que los planes cumplen:
+  - Cada tarea tiene <verify> ejecutable
+  - Los must_haves son observables
+  - No hay dependencias circulares
+  - El scope es razonable (~50% context)
+```
+
+## Paso 7: Presentar al Usuario
+
+```
+Plan creado para: [fase/feature]
+
+Lo que se va a hacer:
+1. [Tarea 1]
+2. [Tarea 2]
+3. [Tarea 3]
+
+Tecnologías verificadas:
+- [Librería] v[versión] (Context7)
+- [Otra] v[versión] (Context7)
+
+¿Quieres que lo ejecute? → /elsabro:execute [fase]
+¿Quieres ver el plan completo? → Dime "muéstrame el plan"
+```
+</process>
+
+<research_protocol>
+## Protocolo de Investigación
+
+### Para Cada Tecnología
+
+```
+1. Resolver librería:
+   mcp__plugin_context7_context7__resolve-library-id
+   Input: nombre de librería
+
+2. Buscar setup:
+   mcp__plugin_context7_context7__query-docs
+   Query: "getting started" o "installation"
+
+3. Buscar patrones:
+   mcp__plugin_context7_context7__query-docs
+   Query: "[feature específica]"
+
+4. Verificar actualidad:
+   WebSearch: "[librería] [año] changes"
+```
+
+### Documentar en RESEARCH.md
+
+```markdown
+# Research: [Fase/Feature]
+
+## Stack Verificado
+| Librería | Versión | Fuente | Notas |
+|----------|---------|--------|-------|
+| next.js | 15.0.3 | Context7 | App Router |
+| prisma | 5.20.0 | Context7 | - |
+
+## Patrones a Usar
+### [Patrón 1]
+Fuente: Context7
+```typescript
+[código verificado]
+```
+
+## Pitfalls
+- [Problema conocido] → [Cómo evitarlo]
+```
+</research_protocol>
+
+<plan_format>
+## Formato de Plan
+
+```markdown
+---
+phase: 1
+plan: 1
+wave: 1
+must_haves:
+  truths:
+    - "[Comportamiento observable]"
+  artifacts:
+    - path: "[archivo]"
+      contains: "[patrón]"
+---
+
+# Plan: [Nombre]
+
+## Objetivo
+[Una oración]
+
+## Contexto
+@.planning/RESEARCH.md
+
+## Tareas
+
+<task type="auto">
+  <name>[Nombre]</name>
+  <files>[Archivos]</files>
+  <action>
+    [Instrucciones específicas con código de Context7]
+  </action>
+  <verify>[Comando ejecutable]</verify>
+  <done>[Criterio observable]</done>
+</task>
+```
+</plan_format>
+
+<parallel_coordination>
+## Coordinación de Ejecución Paralela
+
+### Policy por Defecto: quorum
+
+Este comando usa `policy: quorum` para agentes paralelos:
+
+```
+┌────────────────────────────────────────────────┐
+│  PARALLEL POLICY: quorum                       │
+├────────────────────────────────────────────────┤
+│  Success threshold: >50%                       │
+│  Behavior: Continuar si mayoría tiene éxito   │
+│  On failure: Reportar pero continuar          │
+└────────────────────────────────────────────────┘
+```
+
+### Reporte de Ejecución Paralela
+
+```
+╔══════════════════════════════════════════════════╗
+║  RESEARCH AGENTS COMPLETE                        ║
+╠══════════════════════════════════════════════════╣
+║  Policy: quorum                                  ║
+║  Total: 2 agents                                 ║
+║                                                  ║
+║  ✓ elsabro-planner: SUCCESS (35s)               ║
+║    └─ Created RESEARCH.md, PLAN.md              ║
+║  ✓ elsabro-verifier: SUCCESS (12s)              ║
+║    └─ Plan validated, no issues                 ║
+║                                                  ║
+║  Result: 2/2 (100%) - QUORUM MET                 ║
+║  Status: CONTINUING                              ║
+╚══════════════════════════════════════════════════╝
+```
+
+### Manejo de Fallos en Research
+
+Si un agente de research falla:
+
+```
+╔══════════════════════════════════════════════════╗
+║  🟠 RESEARCH AGENT FAILED                        ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  ✓ elsabro-planner: SUCCESS                     ║
+║  ✗ context7-verifier: FAILED (timeout)          ║
+║                                                  ║
+║  Result: 1/2 (50%) - QUORUM BORDERLINE          ║
+║                                                  ║
+╠══════════════════════════════════════════════════╣
+║  El plan se creó pero sin verificación de       ║
+║  Context7. Puedes:                               ║
+║                                                  ║
+║  [c] Continuar con plan (no verificado)         ║
+║  [r] Reintentar research                         ║
+║  [m] Verificar manualmente con Context7          ║
+╚══════════════════════════════════════════════════╝
+```
+
+### Actualizar Estado
+
+Al completar planificación:
+
+```json
+{
+  "parallelExecution": {
+    "policy": "quorum",
+    "activeAgents": [],
+    "completedAgents": ["elsabro-planner", "elsabro-verifier"],
+    "failedAgents": [],
+    "lastResult": {
+      "total": 2,
+      "success": 2,
+      "quorumMet": true
+    }
+  }
+}
+```
+</parallel_coordination>