debuggera

Shows an agent how to design, debug, or review "debuggera" so the concrete output is a plan, brief, or checklist. The procedure moves through Alcance, Flujo obligatorio, Paso 1. Reproducir. Use it when a new assignment calls for this craft.

O que é debuggera?

debuggera is a Claude Code agent skill that shows an agent how to design, debug, or review "debuggera" so the concrete output is a plan, brief, or checklist. The procedure moves through Alcance, Flujo obligatorio, Paso 1. Reproducir. Use it when a new assignment calls for this craft.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diegovelandiabarajas1-lang/wichinion-render/tree/HEAD/workspace/.opencode/skills/debuggera

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que debuggera faz?

Encuentras la causa raíz de un fallo y la corriges. No aplicas parches que ocultan el síntoma, no cambias cosas "a ver si funciona", y no cierras un bug sin entender por qué ocurrió y por qué la corrección lo resuelve.

Alcance

Depuras cualquier fallo en cualquier lenguaje, framework, arquitectura o entorno: errores de ejecución, fallos intermitentes, regresiones, problemas de rendimiento, fugas de memoria, condiciones de carrera, errores de configuración, fallos en CI/CD o diferencias entre entornos. Produces diagnóstico con causa raíz, corrección, verificación y medida preventiva.

Flujo obligatorio

Paso 1. Reproducir

  1. Consigue el error completo: mensaje, stack trace, logs, código de salida y contexto.
  2. Identifica el entorno donde falla: sistema operativo, versiones, variables, datos de entrada.
  3. Reproduce el fallo de forma consistente; si es intermitente, anota la frecuencia y las condiciones.
  4. Si no puedes reproducirlo, documenta qué has intentado y qué información falta.
  5. Define el comportamiento esperado frente al observado, con precisión.

Paso 2. Aislar

  1. Reduce el caso al mínimo que sigue fallando: quita ruido, dependencias y pasos irrelevantes.
  2. Acota la zona del código o del sistema donde ocurre.
  3. Comprueba qué cambió entre la última vez que funcionó y ahora: commits, dependencias, configuración, datos, entorno.
  4. Descarta hipótesis una por una con evidencia, no por intuición.
  5. Anota cada hipótesis y su resultado, aunque se descarte: el descarte también es información.

Paso 3. Diagnosticar causa raíz

  1. Distingue síntoma de causa: el error visible casi nunca es la causa.
  2. Pregunta "¿por qué?" hasta llegar a la causa que, si se corrige, elimina el fallo.
  3. Verifica la causa con evidencia: reproduce el fallo controlando la variable sospechosa.
  4. Comprueba si el fallo afecta a más sitios del mismo patrón.
  5. Clasifica la causa: error lógico, dato inválido, condición de carrera, configuración, dependencia, entorno, rendimiento o diseño.

Paso 4. Corregir

  1. Corrige la causa raíz, no el síntoma.
  2. Cambia lo mínimo necesario; evita refactorizaciones no relacionadas dentro del mismo fix.
  3. Si un parche temporal es inevitable, márcalo como temporal, explica por qué y abre la tarea para la corrección real.
  4. Añade o actualiza el test que reproduce el fallo antes de dar el fix por bueno.
  5. Revisa efectos secundarios: ¿el fix rompe otro comportamiento?

Paso 5. Verificar

  1. Confirma que el caso original ya no falla.
  2. Ejecuta los tests existentes y el nuevo test del fallo.
  3. Prueba casos límite y variantes del mismo patrón.
  4. Verifica en el entorno real, no solo en local, si aplica.
  5. Si el fallo era intermitente, deja la corrección en observación y define cómo confirmar que no reaparece.

Paso 6. Prevenir

  1. Añade el test de regresión para que el fallo no vuelva sin avisar.
  2. Corrige el mismo patrón en otros sitios afectados.
  3. Identifica por qué el fallo llegó a producción: ¿faltó test, revisión, monitorización, validación?
  4. Propón una medida preventiva concreta: validación, alerta, gate de CI, documentación.
  5. Documenta el post-mortem si el impacto lo justifica (ver Formatos de salida).

Reglas

  1. No apliques cambios sin hipótesis: cada intento responde a una pregunta concreta.
  2. No cambies varias cosas a la vez: si funciona, no sabrás por qué.
  3. No cierres el bug sin causa raíz identificada; "ya no falla" no es un diagnóstico.
  4. Todo hallazgo cita archivo y línea, comando o log concreto.
  5. Separa hechos observados de hipótesis; marca cada uno.
  6. Si falta información o no puedes reproducir, dilo antes de asumir.
  7. Prioriza por impacto: frecuencia, gravedad y alcance del fallo.
  8. Señala problemas del código o del sistema, no de las personas.

Formatos de salida

  1. Diagnóstico en el chat cuando el fallo es puntual y la causa clara.
  2. Informe de depuración cuando el fallo es complejo o intermitente: síntoma, reproducción, hipótesis descartadas, causa raíz, fix, verificación y prevención.
  3. Snippets con archivo y línea para el código afectado y el fix.
  4. Diff del cambio propuesto cuando aplique.
  5. Test de regresión en el lenguaje del proyecto.
  6. Post-mortem cuando el impacto lo justifique: línea de tiempo, causa raíz, impacto, corrección, acciones preventivas con responsable y plazo.
  7. Diagrama Mermaid cuando el fallo implique flujo, secuencia o estado.

Matriz de severidad del fallo

SeveridadDescripciónSLA sugerido
CríticaCaída, pérdida de datos, seguridad comprometidaInmediato
AltaFunción principal rota, sin workaroundMenos de 24 h
MediaFunción secundaria rota o workaround disponibleMenos de 1 semana
BajaMolestia menor, cosmético o caso límite raroBacklog
InfoObservación sin impacto funcionalOpcional

Checklist de salida

  • Error y contexto capturados completos
  • Fallo reproducido o imposibilidad documentada
  • Comportamiento esperado vs observado definido
  • Caso reducido al mínimo
  • Hipótesis planteadas y descartadas con evidencia
  • Causa raíz identificada y verificada
  • Fix aplicado sobre la causa, no el síntoma
  • Test de regresión añadido
  • Verificado en local y en entorno real si aplica
  • Mismo patrón revisado en otros sitios
  • Medida preventiva propuesta
  • Post-mortem redactado si el impacto lo justifica

Prohibiciones

  1. No cambiar código sin hipótesis ni evidencia.
  2. No aplicar parches que oculten el síntoma sin marcar la deuda.
  3. No cambiar varias cosas a la vez.
  4. No declarar resuelto sin verificar el caso original y los tests.
  5. No inventar causas ni logs que no has observado.
  6. No culpar a personas ni a "la máquina": documenta el fallo del sistema.
  7. No ignorar fallos intermitentes por no reproducirlos a la primera.
  8. No refactorizar fuera del alcance del fix.

Habilidades Relacionadas