elsabro 2.0.0

package/skills/sentry-setup.md

@@ -0,0 +1,295 @@
+---
+name: sentry-setup
+description: Skill para integrar Sentry (monitoreo de errores) en cualquier proyecto. Usa este skill cuando el usuario quiere detectar errores en producción.
+---
+
+# Skill: Integrar Sentry
+
+<when_to_use>
+Usar cuando el usuario menciona:
+- "monitoreo de errores"
+- "detectar bugs"
+- "errores en producción"
+- "crash reporting"
+- "sentry"
+- "tracking de errores"
+</when_to_use>
+
+<before_starting>
+## Investigación Obligatoria
+
+**ANTES de instalar, detectar tipo de proyecto y buscar setup actual:**
+
+```
+1. Detectar proyecto:
+   - ¿Tiene package.json? → Node.js
+   - ¿Tiene next.config? → Next.js
+   - ¿Tiene app.json con expo? → Expo/React Native
+   - ¿Tiene requirements.txt? → Python
+
+2. Resolver Sentry para el tipo:
+   mcp__plugin_context7_context7__resolve-library-id("sentry [tipo]")
+
+   Ejemplos:
+   - "sentry nextjs"
+   - "sentry expo"
+   - "sentry react"
+   - "sentry node"
+
+3. Buscar setup actual:
+   mcp__plugin_context7_context7__query-docs(id, "installation configuration")
+```
+</before_starting>
+
+<setup_by_project_type>
+## Setup por Tipo de Proyecto
+
+### Next.js
+
+```bash
+# 1. Instalar (VERIFICAR versión con Context7)
+npx @sentry/wizard@latest -i nextjs
+
+# 2. El wizard crea automáticamente:
+# - sentry.client.config.ts
+# - sentry.server.config.ts
+# - sentry.edge.config.ts
+# - Actualiza next.config.js
+```
+
+### Expo/React Native
+
+```bash
+# 1. Instalar (VERIFICAR con Context7)
+npx expo install @sentry/react-native
+
+# 2. Configurar en app.json
+# VERIFICAR estructura actual con Context7
+```
+
+### React (Vite/CRA)
+
+```bash
+# 1. Instalar (VERIFICAR con Context7)
+npm install @sentry/react
+
+# 2. Inicializar en main.tsx/index.tsx
+# VERIFICAR patrón actual con Context7
+```
+
+### Node.js/Express
+
+```bash
+# 1. Instalar (VERIFICAR con Context7)
+npm install @sentry/node
+
+# 2. Inicializar al inicio del servidor
+# VERIFICAR patrón actual con Context7
+```
+</setup_by_project_type>
+
+<configuration>
+## Configuración Común
+
+### Variables de Entorno
+```bash
+# .env.local (NO commitear)
+SENTRY_DSN=https://xxxxx@xxx.ingest.sentry.io/xxxxx
+
+# Para Next.js también:
+SENTRY_AUTH_TOKEN=sntrys_xxxxx
+```
+
+### DSN
+El DSN (Data Source Name) se obtiene de:
+1. Ir a https://sentry.io
+2. Crear proyecto o seleccionar existente
+3. Settings → Client Keys (DSN)
+
+### Opciones Importantes
+```typescript
+// VERIFICAR opciones actuales con Context7
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,
+
+  // Porcentaje de transacciones a trackear (performance)
+  tracesSampleRate: 1.0, // 100% en dev, reducir en prod
+
+  // Porcentaje de errores a trackear
+  sampleRate: 1.0,
+
+  // Ambiente
+  environment: process.env.NODE_ENV,
+
+  // Release (para source maps)
+  release: process.env.npm_package_version,
+});
+```
+</configuration>
+
+<verification>
+## Verificación
+
+### Paso 1: Verificar instalación
+```bash
+# Ver que las dependencias están instaladas
+npm ls | grep sentry
+```
+
+### Paso 2: Probar que reporta errores
+```typescript
+// Agregar temporalmente en algún lugar
+throw new Error("Test Sentry Error");
+
+// O usar el método oficial:
+Sentry.captureException(new Error("Test error"));
+```
+
+### Paso 3: Verificar en Sentry Dashboard
+1. Ir a https://sentry.io
+2. Seleccionar tu proyecto
+3. Ir a "Issues"
+4. Debería aparecer el error de prueba
+
+### Paso 4: Limpiar
+- Eliminar el error de prueba del código
+</verification>
+
+<user_testing>
+## Guía de Prueba para Usuario
+
+```
+Para ti (Usuario):
+
+1. Ve a https://sentry.io e inicia sesión
+
+2. Selecciona tu proyecto (o créalo si no existe)
+
+3. Ve a "Issues" en el menú lateral
+
+4. ¿Ves el error de prueba "Test Sentry Error"?
+   - SÍ → Sentry está funcionando correctamente
+   - NO → Espera 1-2 minutos y recarga (puede haber delay)
+
+5. Si después de 2 minutos no aparece:
+   - Verifica que el DSN es correcto
+   - Verifica que la app está corriendo
+   - Dime qué ves en la consola
+```
+</user_testing>
+
+<error_boundary>
+## Error Boundary (React/Next.js)
+
+Para capturar errores de UI:
+
+```tsx
+// components/ErrorBoundary.tsx
+// VERIFICAR patrón actual con Context7
+
+'use client';
+
+import * as Sentry from '@sentry/nextjs';
+import { Component, ReactNode } from 'react';
+
+interface Props {
+  children: ReactNode;
+  fallback?: ReactNode;
+}
+
+interface State {
+  hasError: boolean;
+}
+
+export class ErrorBoundary extends Component<Props, State> {
+  constructor(props: Props) {
+    super(props);
+    this.state = { hasError: false };
+  }
+
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+
+  componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
+    Sentry.captureException(error, { extra: errorInfo });
+  }
+
+  render() {
+    if (this.state.hasError) {
+      return this.props.fallback || <div>Algo salió mal</div>;
+    }
+    return this.props.children;
+  }
+}
+```
+
+Uso:
+```tsx
+// app/layout.tsx
+<ErrorBoundary fallback={<ErrorPage />}>
+  {children}
+</ErrorBoundary>
+```
+</error_boundary>
+
+<common_issues>
+## Problemas Comunes
+
+### "Events not showing in Sentry"
+- Verificar DSN es correcto
+- Verificar que la app está corriendo
+- Verificar que no hay adblocker bloqueando
+- Esperar 1-2 minutos (hay delay)
+
+### "Source maps not working"
+- Verificar SENTRY_AUTH_TOKEN
+- Verificar configuración de releases
+- Ejecutar build con source maps habilitados
+
+### "Too many events"
+- Reducir tracesSampleRate
+- Configurar filtering de errores conocidos
+- Usar beforeSend para filtrar
+
+### "Performance monitoring slow"
+- Reducir tracesSampleRate a 0.1 (10%)
+- Configurar sampling por tipo de transacción
+</common_issues>
+
+<best_practices>
+## Mejores Prácticas
+
+1. **Nunca commitear DSN en código**
+   - Usar variables de entorno
+
+2. **Configurar releases**
+   - Para ver en qué versión ocurrió el error
+
+3. **Agregar contexto**
+   ```typescript
+   Sentry.setUser({ id: userId, email: userEmail });
+   Sentry.setContext("feature", { name: "checkout" });
+   ```
+
+4. **Configurar alertas**
+   - En Sentry Dashboard: Alerts → Create Alert Rule
+   - Notificar por email/Slack cuando hay errores nuevos
+
+5. **Revisar errores regularmente**
+   - Al menos una vez por semana
+   - Priorizar errores que afectan a muchos usuarios
+</best_practices>
+
+<next_steps>
+## Después del Setup
+
+Una vez que Sentry está funcionando:
+
+1. Configurar alertas en el dashboard de Sentry
+2. Agregar tags de usuario para debugging
+3. Configurar source maps para ver código real
+4. Reducir sample rates para producción
+
+Continuar con `/elsabro:plan` para la siguiente feature.
+</next_steps>

package/templates/error-handling-config.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "version": "1.0",
+  "description": "ELSABRO Error Handling Configuration",
+
+  "severityLevels": {
+    "CRITICAL": {
+      "emoji": "🔴",
+      "canContinue": false,
+      "requiresApproval": true,
+      "description": "Error fatal - debe parar inmediatamente",
+      "examples": [
+        "SESSION.md corrupto o faltante",
+        "Dependencias incompatibles",
+        "Archivos de configuración inválidos"
+      ]
+    },
+    "HIGH": {
+      "emoji": "🟠",
+      "canContinue": true,
+      "requiresApproval": true,
+      "description": "Error importante - debería parar, puede forzar continuar",
+      "examples": [
+        "Tests fallando",
+        "Build fallido",
+        "Validación de schema falló"
+      ]
+    },
+    "MEDIUM": {
+      "emoji": "🟡",
+      "canContinue": true,
+      "requiresApproval": false,
+      "description": "Warning - puede continuar con precaución",
+      "examples": [
+        "Lint warnings",
+        "Deprecation warnings",
+        "Coverage bajo pero aceptable"
+      ]
+    },
+    "LOW": {
+      "emoji": "⬜",
+      "canContinue": true,
+      "requiresApproval": false,
+      "description": "Informativo - continuar normal",
+      "examples": [
+        "Info messages",
+        "Retry exitoso después de fallo",
+        "Task completado con warnings menores"
+      ]
+    }
+  },
+
+  "parallelPolicies": {
+    "fail_fast": {
+      "description": "Para todo si cualquier agente falla",
+      "useWhen": "Todos los resultados son críticos (deploy, tests críticos)",
+      "behavior": {
+        "onFirstFailure": "stop_all",
+        "waitForRunning": false,
+        "rollbackOnFailure": true
+      }
+    },
+    "quorum": {
+      "description": "Continúa si >50% de agentes tienen éxito",
+      "useWhen": "Resultados parciales son útiles (exploración, research)",
+      "behavior": {
+        "onFirstFailure": "continue",
+        "waitForRunning": true,
+        "successThreshold": 0.5
+      }
+    },
+    "continue_all": {
+      "description": "Continúa siempre, reporta fallos al final",
+      "useWhen": "Todos los agentes son independientes",
+      "behavior": {
+        "onFirstFailure": "continue",
+        "waitForRunning": true,
+        "successThreshold": 0
+      }
+    },
+    "critical_path": {
+      "description": "Para solo si falla un agente marcado como crítico",
+      "useWhen": "Algunos agentes son críticos, otros opcionales",
+      "behavior": {
+        "onFirstFailure": "check_criticality",
+        "waitForRunning": true,
+        "criticalAgents": []
+      }
+    }
+  },
+
+  "retryDefaults": {
+    "maxAttempts": 3,
+    "baseDelayMs": 1000,
+    "maxDelayMs": 10000,
+    "backoffMultiplier": 2,
+    "timeoutPerAttemptMs": 30000,
+    "totalTimeoutMs": 120000
+  },
+
+  "errorPatterns": {
+    "SESSION_MISSING": {
+      "pattern": "SESSION.md not found|No session file",
+      "severity": "CRITICAL",
+      "suggestedAction": "/elsabro:start para iniciar nueva sesión"
+    },
+    "TESTS_FAILED": {
+      "pattern": "test.*fail|FAIL.*test|npm test.*exit code 1",
+      "severity": "HIGH",
+      "suggestedAction": "/elsabro:debug para investigar fallos"
+    },
+    "BUILD_FAILED": {
+      "pattern": "build.*fail|compilation.*error|tsc.*error",
+      "severity": "HIGH",
+      "suggestedAction": "Revisar errores de compilación"
+    },
+    "LINT_WARNINGS": {
+      "pattern": "warning.*lint|eslint.*warning",
+      "severity": "MEDIUM",
+      "suggestedAction": "Considerar arreglar warnings antes de commit"
+    },
+    "DEPENDENCY_MISSING": {
+      "pattern": "Cannot find module|Module not found",
+      "severity": "HIGH",
+      "suggestedAction": "npm install para instalar dependencias"
+    },
+    "GIT_CONFLICT": {
+      "pattern": "CONFLICT|merge conflict|Automatic merge failed",
+      "severity": "HIGH",
+      "suggestedAction": "Resolver conflictos manualmente"
+    },
+    "TIMEOUT": {
+      "pattern": "timeout|timed out|ETIMEDOUT",
+      "severity": "HIGH",
+      "suggestedAction": "Reintentar o verificar conectividad"
+    }
+  }
+}

package/templates/session-state.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "Template para .planning/SESSION-STATE.json",
+
+  "template": {
+    "version": "1.0",
+    "createdAt": "",
+    "lastUpdated": "",
+    "status": "active",
+
+    "context": {
+      "milestone": "",
+      "phase": "",
+      "progress": 0,
+      "currentTask": ""
+    },
+
+    "checkpoints": [
+      {
+        "name": "",
+        "completedAt": "",
+        "artifacts": []
+      }
+    ],
+
+    "git": {
+      "branch": "",
+      "lastCommit": "",
+      "uncommittedFiles": 0
+    },
+
+    "errors": {
+      "count": 0,
+      "lastError": null,
+      "warnings": []
+    },
+
+    "parallelExecution": {
+      "policy": "quorum",
+      "activeAgents": [],
+      "completedAgents": [],
+      "failedAgents": []
+    },
+
+    "retry": {
+      "currentAttempt": 0,
+      "maxAttempts": 3,
+      "lastAttemptAt": null,
+      "totalTimeSpentMs": 0
+    },
+
+    "recovery": {
+      "lastSuccessfulStep": "",
+      "resumeFrom": "",
+      "notes": ""
+    }
+  },
+
+  "validation": {
+    "requiredFields": [
+      "version",
+      "createdAt",
+      "status",
+      "context.milestone"
+    ],
+    "stalenessWarningDays": 7,
+    "stalenessErrorDays": 30
+  }
+}

package/templates/starters/.gitkeep

@@ -0,0 +1,2 @@
+# Starter templates will be added here
+# Each subdirectory contains a project starter template

package/workflows/.gitkeep

@@ -0,0 +1,2 @@
+# Workflow definitions will be added here
+# Workflows are multi-step processes that can be executed