elsabro 2.1.0 → 2.3.0

package/skills/sentry-setup.md

@@ -1,6 +1,14 @@
 ---
 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.
+tags:
+  - monitoring
+  - error-tracking
+  - production
+  - debugging
+  - observability
+difficulty: intermediate
+estimated_time: 15-30 minutes
 ---
 
 # Skill: Integrar Sentry
@@ -15,6 +23,32 @@ Usar cuando el usuario menciona:
 - "tracking de errores"
 </when_to_use>
 
+<pre_requisites>
+## Pre-requisitos
+
+- Node.js 18+ instalado
+- Proyecto existente (Next.js, React, Node.js, o Expo)
+- Cuenta en Sentry (https://sentry.io) - tier gratuito disponible
+- DSN del proyecto de Sentry
+</pre_requisites>
+
+<project_structure>
+## Estructura de Archivos Resultante
+
+```
+proyecto/
+├── sentry.client.config.ts    # Config cliente (Next.js)
+├── sentry.server.config.ts    # Config servidor (Next.js)
+├── sentry.edge.config.ts      # Config edge runtime (Next.js)
+├── next.config.js             # Actualizado con withSentryConfig
+├── .env.local
+│   ├── SENTRY_DSN=...
+│   └── SENTRY_AUTH_TOKEN=...
+└── components/
+    └── ErrorBoundary.tsx      # Opcional: error boundary
+```
+</project_structure>
+
 <before_starting>
 ## Investigación Obligatoria
 
@@ -47,8 +81,8 @@ Usar cuando el usuario menciona:
 ### Next.js
 
 ```bash
-# 1. Instalar (VERIFICAR versión con Context7)
-npx @sentry/wizard@latest -i nextjs
+# 1. Instalar Sentry 8.x para Next.js
+npx @sentry/wizard@8 -i nextjs
 
 # 2. El wizard crea automáticamente:
 # - sentry.client.config.ts
@@ -70,8 +104,8 @@ npx expo install @sentry/react-native
 ### React (Vite/CRA)
 
 ```bash
-# 1. Instalar (VERIFICAR con Context7)
-npm install @sentry/react
+# 1. Instalar Sentry React 8.x
+npm install @sentry/react@^8.0.0
 
 # 2. Inicializar en main.tsx/index.tsx
 # VERIFICAR patrón actual con Context7
@@ -80,8 +114,8 @@ npm install @sentry/react
 ### Node.js/Express
 
 ```bash
-# 1. Instalar (VERIFICAR con Context7)
-npm install @sentry/node
+# 1. Instalar Sentry Node 8.x
+npm install @sentry/node@^8.0.0
 
 # 2. Inicializar al inicio del servidor
 # VERIFICAR patrón actual con Context7
@@ -189,7 +223,7 @@ Para capturar errores de UI:
 
 'use client';
 
-import * as Sentry from '@sentry/nextjs';
+import * as Sentry from '@sentry/nextjs'; // v8.x
 import { Component, ReactNode } from 'react';
 
 interface Props {

package/skills/techdebt.md

@@ -0,0 +1,289 @@
+---
+name: techdebt
+description: Escaneo de deuda tecnica - codigo duplicado, TODOs, dependencias desactualizadas
+trigger: /elsabro:audit-debt
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+argument-hint: "[path] - directorio a escanear (default: .)"
+---
+
+# ELSABRO: Tech Debt Scanner
+
+<objective>
+Escanear el proyecto en busca de deuda tecnica, codigo duplicado, y areas de mejora.
+Generar reporte estructurado compatible con el flujo de planificacion ELSABRO.
+</objective>
+
+<task_integration>
+## Integracion con Tasks API
+
+Al iniciar escaneo:
+
+```
+TaskCreate:
+  description: "Audit de deuda tecnica: [path]"
+  status: in_progress
+```
+
+Actualizar progreso por categoria escaneada.
+Al finalizar, incluir resumen con health score.
+</task_integration>
+
+<triggers>
+## Triggers
+
+- `/elsabro:audit-debt` - Escaneo completo del proyecto
+- `/elsabro:audit-debt [path]` - Escaneo de directorio especifico
+- `/elsabro:audit-debt --quick` - Solo issues CRITICAL y HIGH
+- `/elsabro:audit-debt --save` - Guardar reporte en .planning/TECHDEBT.md
+</triggers>
+
+<scan_categories>
+## Categorias de Escaneo
+
+### 1. Codigo Duplicado
+Buscar patrones repetidos que podrian extraerse:
+- Funciones similares en diferentes archivos
+- Logica copy-paste con pequenas variaciones
+- Componentes que hacen lo mismo con diferentes props
+
+### 2. TODOs y FIXMEs
+Buscar comentarios pendientes con contexto:
+```
+grep -r "TODO\|FIXME\|HACK\|XXX" --include="*.ts" --include="*.tsx"
+```
+
+### 3. Dependencias Desactualizadas
+```
+npm outdated
+```
+
+### 4. Complejidad Ciclomatica
+- Funciones con mas de 50 lineas
+- Mas de 4 niveles de anidacion
+- Mas de 10 ramas condicionales
+
+### 5. Cobertura de Tests
+Si hay tests configurados:
+```
+npm test -- --coverage --silent
+```
+
+### 6. Tipos Debiles (TypeScript)
+- `any` explicitos
+- `as unknown as X` casts
+- `// @ts-ignore` o `// @ts-expect-error`
+
+### 7. Console.logs Olvidados
+```
+grep -r "console.log\|console.warn\|console.error" --include="*.ts" --include="*.tsx" src/
+```
+
+### 8. Imports No Utilizados
+Detectar via ESLint/TypeScript.
+
+### 9. Variables de Entorno
+Verificar que `.env.example` tenga todas las variables necesarias.
+
+### 10. Archivos Grandes
+Archivos con mas de 300 lineas que podrian dividirse.
+</scan_categories>
+
+<severity_classification>
+## Clasificacion de Severidad
+
+Usar clasificacion consistente con ELSABRO:
+
+| Severity | Emoji | Criterio |
+|----------|-------|----------|
+| CRITICAL | [CRITICAL] | Vulnerabilidades de seguridad, builds rotos |
+| HIGH | [HIGH] | Major versions atrasados, codigo sin tests criticos |
+| MEDIUM | [MEDIUM] | Minor versions, complejidad alta |
+| LOW | [LOW] | Nitpicks, style issues, patch versions |
+
+### Reglas de Clasificacion
+
+**CRITICAL:**
+- Vulnerabilidades CVE conocidas
+- Secretos expuestos
+- Memory leaks confirmados
+- Tests principales fallando
+
+**HIGH:**
+- Codigo duplicado > 50 lineas
+- Archivos > 500 lineas
+- TODOs con "FIXME" o "URGENT"
+- Dependencias major atrasadas
+
+**MEDIUM:**
+- Uso de `any` en TypeScript
+- Funciones > 100 lineas
+- TODOs generales > 30 dias
+- Console.logs en produccion
+
+**LOW:**
+- Naming conventions
+- Imports no utilizados
+- Comentarios desactualizados
+- Dependencias patch atrasadas
+</severity_classification>
+
+<output_format>
+## Formato de Output
+
+```markdown
+# Tech Debt Report - {{PROJECT_NAME}}
+
+> Generado: {{DATE}}
+> Path escaneado: {{PATH}}
+
+## Resumen Ejecutivo
+
+| Categoria | CRITICAL | HIGH | MEDIUM | LOW |
+|-----------|----------|------|--------|-----|
+| Duplicacion | 0 | 2 | 5 | 3 |
+| TODOs | 1 | 4 | 8 | 2 |
+| Dependencias | 0 | 1 | 3 | 12 |
+| Complejidad | 0 | 3 | 7 | 15 |
+| Tests | 2 | 5 | 10 | - |
+| Tipos | 0 | 8 | 15 | 20 |
+
+**Total Issues**: 125
+**Health Score**: 72/100
+
+---
+
+## [CRITICAL] Issues Criticos (Resolver AHORA)
+
+### Vulnerabilidad en lodash@4.17.15
+- **Ubicacion**: package.json
+- **Accion**: `npm update lodash`
+- **CVE**: CVE-2021-23337
+
+---
+
+## [HIGH] Issues Altos (Resolver esta semana)
+
+### Codigo duplicado: formatDate
+- **Archivos**:
+  - src/utils/format.ts:45-67
+  - src/helpers/date.ts:12-34
+- **Lineas duplicadas**: 22
+- **Sugerencia**: Crear `src/lib/date-utils.ts`
+
+---
+
+## [MEDIUM] Issues Medios (Backlog)
+
+### Uso excesivo de `any`
+- **Total**: 15 ocurrencias
+- **Archivos principales**:
+  - src/api/client.ts (5)
+  - src/utils/helpers.ts (4)
+- **Sugerencia**: Crear tipos especificos
+
+---
+
+## [LOW] Issues Menores (Opcional)
+
+### Console.logs en codigo
+- **Total**: 8 ocurrencias
+- **Sugerencia**: Usar logger estructurado
+
+---
+
+## Recomendaciones
+
+1. [ ] Crear ticket para resolver vulnerabilidades de seguridad
+2. [ ] Dedicar 20% del sprint a reducir TODOs
+3. [ ] Agregar pre-commit hook para prevenir console.logs
+4. [ ] Configurar ESLint para detectar `any`
+
+---
+
+## Proximo Escaneo
+
+Ejecutar `/elsabro:audit-debt` despues de cada merge a main.
+```
+</output_format>
+
+<health_score>
+## Calculo de Health Score
+
+```
+Base: 100 puntos
+
+Deducciones:
+- CRITICAL: -15 puntos cada uno
+- HIGH: -5 puntos cada uno
+- MEDIUM: -1 punto cada uno
+- LOW: -0.25 puntos cada uno
+
+Minimo: 0 puntos
+```
+
+### Interpretacion
+
+| Score | Estado | Accion |
+|-------|--------|--------|
+| 90-100 | Excelente | Mantener |
+| 70-89 | Bueno | Monitorear |
+| 50-69 | Aceptable | Planificar mejoras |
+| 30-49 | Preocupante | Priorizar deuda |
+| 0-29 | Critico | Parar features, resolver deuda |
+</health_score>
+
+<save_report>
+## Guardar Reporte
+
+Con flag `--save`, guardar en `.planning/TECHDEBT.md`:
+
+```markdown
+# Tech Debt Tracking
+
+## Ultimo Escaneo: {{DATE}}
+
+[Contenido del reporte]
+
+## Historial de Health Score
+
+| Fecha | Score | CRITICAL | HIGH | Notas |
+|-------|-------|----------|------|-------|
+| 2024-01-20 | 72 | 0 | 5 | Post-refactor |
+| 2024-01-15 | 65 | 1 | 8 | Antes de limpieza |
+| 2024-01-10 | 58 | 2 | 12 | Inicial |
+```
+</save_report>
+
+<integration_planning>
+## Integracion con Planificacion ELSABRO
+
+Ofrecer despues del escaneo:
+
+```
+"Encontre {{N}} issues criticos y {{M}} altos.
+
+Opciones:
+1. `/elsabro:plan debt-reduction` - Crear plan para resolver deuda
+2. Agregar issues a fase existente
+3. Solo guardar reporte para referencia
+
+Que prefieres?"
+```
+</integration_planning>
+
+<automatic_scheduling>
+## Programacion Automatica
+
+Sugerir al usuario agregar a su workflow:
+- Final de cada sesion de trabajo
+- Antes de cada PR
+- Semanalmente como rutina
+- Post-merge a main
+</automatic_scheduling>