elsabro 2.0.0

package/commands/elsabro/verify.md

@@ -0,0 +1,207 @@
+---
+name: verify
+description: Verificar que una fase o feature funciona correctamente
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+  - mcp__plugin_playwright_playwright__*
+argument-hint: "[número de fase o 'manual']"
+---
+
+# ELSABRO: Verify
+
+<objective>
+Verificar que una fase o feature cumple con sus objetivos usando:
+- Tests automáticos
+- Build verification
+- Verificación manual guiada cuando es necesario
+</objective>
+
+<process>
+## Paso 1: Identificar Qué Verificar
+
+Si hay argumento numérico → Verificar fase del ROADMAP
+Si argumento es "manual" → Verificación manual completa
+Si no hay argumento → Verificar último trabajo realizado
+
+## Paso 2: Cargar Contexto
+
+```bash
+# Buscar archivos de verificación
+ls .planning/*-VERIFICATION.md
+ls .planning/*-SUMMARY.md
+```
+
+## Paso 3: Ejecutar Verificaciones Automáticas
+
+```
+Task(elsabro-verifier):
+  Verifica fase [N]:
+
+  1. Leer must_haves de los PLAN.md
+  2. Ejecutar comandos de <verify>
+  3. Verificar artifacts existen
+  4. Verificar truths son verdaderas
+  5. Generar VERIFICATION.md
+```
+
+## Paso 4: Verificación Manual (si necesaria)
+
+Presentar al usuario pasos claros:
+
+```
+Para ti (Usuario):
+
+Vamos a verificar que todo funciona correctamente.
+Por favor sigue estos pasos:
+
+1. [Paso claro y específico]
+   → Resultado esperado: [descripción]
+
+2. [Siguiente paso]
+   → Resultado esperado: [descripción]
+
+Cuando termines, dime:
+- ¿Funcionó todo como se describe?
+- ¿Hubo algo diferente o algún error?
+```
+
+## Paso 5: Reportar Resultado
+
+### Si todo pasa:
+```
+✓ Verificación completada
+
+Fase [N] verificada correctamente:
+- [X] Build exitoso
+- [X] Tests pasan
+- [X] Funcionalidad verificada
+
+¿Siguiente paso?
+- Continuar con fase [N+1]: /elsabro:plan [N+1]
+- Revisar el código: Ver archivos modificados
+```
+
+### Si hay problemas:
+```
+⚠ Verificación encontró problemas
+
+Problemas detectados:
+1. [Problema]
+2. [Problema]
+
+Opciones:
+1. Investigar y arreglar: /elsabro:debug
+2. Ver detalles: cat .planning/[N]-VERIFICATION.md
+3. Ignorar y continuar (no recomendado)
+```
+</process>
+
+<verification_levels>
+## Niveles de Verificación
+
+### Level 1: Exists
+- ¿El archivo/función existe?
+- Verificación: Glob/Grep
+
+### Level 2: Substantive
+- ¿El código tiene la lógica esperada?
+- Verificación: Grep patrones específicos
+
+### Level 3: Wired
+- ¿Los componentes están conectados?
+- Verificación: Import statements, route definitions
+
+### Level 4: Works
+- ¿Funciona como se espera?
+- Verificación: Tests, verificación manual
+</verification_levels>
+
+<manual_verification_templates>
+## Templates de Verificación Manual
+
+### Para UI/Frontend
+```
+Verificación manual:
+
+1. Abre tu navegador en http://localhost:3000
+2. Ve a [ruta específica]
+3. [Acción]: Click en [elemento]
+4. Deberías ver: [resultado esperado]
+
+¿Lo ves?
+```
+
+### Para API
+```
+Verificación manual:
+
+1. Abre una terminal
+2. Ejecuta: curl http://localhost:3000/api/[endpoint]
+3. Deberías ver: {"success": true, ...}
+
+¿Recibes esa respuesta?
+```
+
+### Para Base de Datos
+```
+Verificación manual:
+
+1. Ejecuta: npx prisma studio
+2. Se abre una ventana en tu navegador
+3. Deberías ver las tablas: [lista]
+
+¿Las ves?
+```
+
+### Para Autenticación
+```
+Verificación manual:
+
+1. Abre http://localhost:3000/login
+2. Ingresa un email y contraseña de prueba
+3. Click en "Iniciar sesión"
+4. Deberías ser redirigido a: [ruta]
+
+¿Funcionó?
+```
+</manual_verification_templates>
+
+<gap_handling>
+## Manejo de Gaps
+
+Cuando se encuentra un gap:
+
+```yaml
+gaps:
+  - type: missing_file
+    path: src/components/Button.tsx
+    severity: critical
+    action: crear archivo
+
+  - type: test_failing
+    test: "should validate email"
+    error: "Expected true, got false"
+    severity: high
+    action: revisar lógica
+
+  - type: behavior_mismatch
+    expected: "Redirige a /dashboard"
+    actual: "Se queda en /login"
+    severity: medium
+    action: verificar auth middleware
+```
+
+### Por Severidad:
+
+| Severidad | Acción |
+|-----------|--------|
+| critical | STOP - no continuar hasta resolver |
+| high | Crear plan de corrección |
+| medium | Documentar para después |
+| low | Opcional arreglar |
+</gap_handling>

package/hooks/dist/.gitkeep

@@ -0,0 +1,2 @@
+# Compiled hooks will be placed here
+# Run: npm run build:hooks to compile from hooks/src/

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "elsabro",
+  "version": "2.0.0",
+  "description": "Sistema de desarrollo AI-powered para Claude Code - El mejor asistente para crear apps sin experiencia previa",
+  "bin": {
+    "elsabro": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "agents",
+    "skills",
+    "templates",
+    "workflows",
+    "references",
+    "hooks/dist"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "development",
+    "no-code",
+    "low-code",
+    "nextjs",
+    "expo",
+    "react-native"
+  ],
+  "author": "CUBAIT",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goat1990/elsabro.git"
+  },
+  "homepage": "https://github.com/goat1990/elsabro",
+  "bugs": {
+    "url": "https://github.com/goat1990/elsabro/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  }
+}

package/references/error-handling-instructions.md

@@ -0,0 +1,312 @@
+# Instrucciones de Error Handling para Agentes ELSABRO
+
+Este documento define cómo los agentes deben manejar errores de forma consistente.
+
+## Clasificación de Errores
+
+Cuando encuentres un error, clasifícalo usando esta escala:
+
+### 🔴 CRITICAL - No puede continuar
+
+```json
+{
+  "severity": "CRITICAL",
+  "code": "ERROR_CODE",
+  "message": "Descripción del error",
+  "canContinue": false,
+  "suggestedAction": "Qué debe hacer el usuario"
+}
+```
+
+**Ejemplos:**
+- SESSION.md corrupto o faltante
+- Archivos de configuración críticos inválidos
+- Dependencias con versiones incompatibles
+- Estado de git inconsistente (detached HEAD, conflictos)
+
+**Acción:** Parar inmediatamente, mostrar error, sugerir solución.
+
+---
+
+### 🟠 HIGH - Debería parar
+
+```json
+{
+  "severity": "HIGH",
+  "code": "ERROR_CODE",
+  "message": "Descripción del error",
+  "canContinue": true,
+  "suggestedAction": "Qué debe hacer el usuario",
+  "options": ["fix", "skip", "abort"]
+}
+```
+
+**Ejemplos:**
+- Tests fallando
+- Build fallido
+- Validación de schema falló
+- API calls fallando
+
+**Acción:** Mostrar error, ofrecer opciones:
+- `[f]` Arreglar ahora
+- `[s]` Saltar (no recomendado)
+- `[a]` Abortar
+
+---
+
+### 🟡 MEDIUM - Warning
+
+```json
+{
+  "severity": "MEDIUM",
+  "code": "WARNING_CODE",
+  "message": "Descripción del warning",
+  "canContinue": true,
+  "note": "Información adicional"
+}
+```
+
+**Ejemplos:**
+- Lint warnings
+- Deprecation warnings
+- Coverage bajo pero aceptable
+- Archivos sin usar detectados
+
+**Acción:** Mostrar warning, continuar automáticamente.
+
+---
+
+### ⬜ LOW - Informativo
+
+```json
+{
+  "severity": "LOW",
+  "code": "INFO_CODE",
+  "message": "Información"
+}
+```
+
+**Ejemplos:**
+- Retry exitoso después de fallo temporal
+- Operación completada con notas
+- Sugerencias de mejora
+
+**Acción:** Registrar, continuar.
+
+---
+
+## Display de Errores
+
+Usa este formato visual para errores:
+
+### Error CRITICAL
+```
+╔══════════════════════════════════════════════════╗
+║  🔴 ERROR: SESSION_MISSING                       ║
+║  Severity: CRITICAL                              ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  No se encontró el archivo de sesión             ║
+║                                                  ║
+║  El archivo .planning/SESSION.md no existe       ║
+║  o está corrupto.                                ║
+║                                                  ║
+╠══════════════════════════════════════════════════╣
+║  ACCIÓN REQUERIDA:                               ║
+║  → /elsabro:start para iniciar nueva sesión      ║
+╚══════════════════════════════════════════════════╝
+```
+
+### Error HIGH con Opciones
+```
+╔══════════════════════════════════════════════════╗
+║  🟠 ERROR: TESTS_FAILED                          ║
+║  Severity: HIGH                                  ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  3 tests fallaron en src/__tests__/              ║
+║                                                  ║
+║  Detalles:                                       ║
+║  - Profile.test.ts: Expected "John" got null    ║
+║  - Auth.test.ts: Timeout after 5000ms           ║
+║                                                  ║
+╠══════════════════════════════════════════════════╣
+║  Opciones:                                       ║
+║  [d] /elsabro:debug - Investigar fallos         ║
+║  [s] Saltar tests (no recomendado)              ║
+║  [a] Abortar operación                          ║
+╚══════════════════════════════════════════════════╝
+```
+
+### Warning MEDIUM
+```
+┌──────────────────────────────────────────────────┐
+│  🟡 WARNING: LINT_WARNINGS                       │
+├──────────────────────────────────────────────────┤
+│  5 lint warnings encontrados                     │
+│  Considera arreglar antes de commit              │
+│                                                  │
+│  Continuando automáticamente...                  │
+└──────────────────────────────────────────────────┘
+```
+
+---
+
+## Manejo de Ejecución Paralela
+
+Cuando ejecutes múltiples agentes en paralelo, sigue estas reglas:
+
+### Policy: fail_fast
+```
+Si cualquier agente falla → PARAR TODO
+- Detener agentes en ejecución
+- Reportar qué agente falló
+- NO continuar con siguientes pasos
+```
+
+### Policy: quorum (default)
+```
+Continuar si >50% tienen éxito
+- Esperar a que todos terminen
+- Contar éxitos vs fallos
+- Si ≥50% OK → continuar con resultados parciales
+- Si <50% OK → PARAR y reportar
+```
+
+### Policy: continue_all
+```
+Continuar siempre
+- Esperar a que todos terminen
+- Recopilar todos los resultados
+- Reportar fallos pero continuar
+```
+
+### Policy: critical_path
+```
+Para solo si falla un agente crítico
+- Marcar agentes como críticos u opcionales
+- Si agente crítico falla → PARAR
+- Si agente opcional falla → Continuar
+- Usar cuando algunos agentes son esenciales
+```
+
+Ejemplo de configuración:
+```json
+{
+  "criticalAgents": ["elsabro-executor", "elsabro-verifier"],
+  "optionalAgents": ["elsabro-analyzer", "elsabro-documenter"]
+}
+```
+
+### Reporte de Ejecución Paralela
+```
+╔══════════════════════════════════════════════════╗
+║  PARALLEL EXECUTION COMPLETE                     ║
+╠══════════════════════════════════════════════════╣
+║  Policy: quorum                                  ║
+║  Total: 4 agents                                 ║
+║                                                  ║
+║  ✓ Agent 1 (code-reviewer): SUCCESS (45s)       ║
+║  ✓ Agent 2 (typescript-pro): SUCCESS (32s)      ║
+║  ✗ Agent 3 (silent-failure): FAILED (timeout)   ║
+║  ✓ Agent 4 (test-analyzer): SUCCESS (28s)       ║
+║                                                  ║
+║  Result: 3/4 (75%) - QUORUM MET                  ║
+║  Status: CONTINUING                              ║
+╚══════════════════════════════════════════════════╝
+```
+
+---
+
+## Manejo de Retry
+
+Cuando una operación falle, usa retry con backoff exponencial:
+
+### Configuración Default
+```
+Attempt 1: Ejecutar inmediatamente
+Attempt 2: Esperar 1s, reintentar
+Attempt 3: Esperar 2s, reintentar
+(Máximo 3 intentos, timeout total 2 min)
+```
+
+### Reporte de Retry
+```
+┌──────────────────────────────────────────────────┐
+│  RETRY: npm test                                 │
+├──────────────────────────────────────────────────┤
+│  Attempt 1/3: FAILED (timeout)                   │
+│  Waiting 1s before retry...                      │
+│                                                  │
+│  Attempt 2/3: FAILED (exit code 1)               │
+│  Waiting 2s before retry...                      │
+│                                                  │
+│  Attempt 3/3: FAILED (exit code 1)               │
+│                                                  │
+│  ❌ All attempts exhausted                       │
+│  → Error escalated to user                       │
+└──────────────────────────────────────────────────┘
+```
+
+### Después de Agotar Retries
+```
+╔══════════════════════════════════════════════════╗
+║  🟠 RETRY EXHAUSTED: npm test                    ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  Intentos: 3/3 agotados                          ║
+║  Tiempo total: 8.5s                              ║
+║                                                  ║
+║  Último error:                                   ║
+║  > Test suite failed to run                      ║
+║  > Cannot find module '@/utils'                  ║
+║                                                  ║
+╠══════════════════════════════════════════════════╣
+║  El problema parece ser:                         ║
+║  → Dependencia faltante o path alias incorrecto  ║
+║                                                  ║
+║  Opciones:                                       ║
+║  [d] Investigar con /elsabro:debug               ║
+║  [r] Reintentar después de arreglar              ║
+║  [a] Abortar                                     ║
+╚══════════════════════════════════════════════════╝
+```
+
+---
+
+## Actualización de Estado
+
+Después de cada operación significativa, actualiza `.planning/SESSION-STATE.json`:
+
+```json
+{
+  "lastUpdated": "2024-01-20T15:30:00Z",
+  "context": {
+    "milestone": "M001",
+    "phase": "P3",
+    "progress": 65,
+    "currentTask": "Implement user profile"
+  },
+  "errors": {
+    "count": 1,
+    "lastError": {
+      "code": "TESTS_FAILED",
+      "severity": "HIGH",
+      "at": "2024-01-20T15:25:00Z",
+      "resolved": false
+    }
+  }
+}
+```
+
+---
+
+## Checklist para Agentes
+
+Antes de reportar "completado":
+
+- [ ] ¿Hubo errores? → Clasificados y reportados
+- [ ] ¿Hubo warnings? → Listados al final
+- [ ] ¿Estado actualizado? → SESSION-STATE.json actualizado
+- [ ] ¿Retry necesario? → Intentado con backoff
+- [ ] ¿Ejecución paralela? → Política aplicada, resultados agregados