SKILL

/systematic-debugging

Debugging de 4 fases basado en análisis de causa raíz: reproducción, hipótesis, prueba aislada y defensa en profundidad.

/systematic-debugging

Skill Claude Code
#Debugging #Desarrollo #Productividad

Descripción

¿Qué hace? /systematic-debugging aplica un proceso de debugging de 4 fases basado en análisis de causa raíz: (1) Reproducción y observación, (2) Formulación de hipótesis, (3) Prueba de hipótesis de forma aislada, (4) Defensa en profundidad.

Evita el debugging por prueba y error donde Claude va cambiando cosas al azar esperando que algo funcione. El proceso documentado también sirve como postmortem reutilizable.

Ejemplos de uso

Bug intermitente en formulario de reserva

Claude no intenta "arreglarlo" al azar. Fase 1: intenta reproducir el error de forma controlada con dos peticiones simultáneas. Fase 2: formula la hipótesis "race condition en la transacción". Fase 3: prueba la hipótesis de forma aislada con un test específico. Fase 4: aplica la solución con defensas adicionales (timeout, retry). Mucho más fiable que cambiar cosas a ver qué pasa.

/systematic-debugging El formulario de reserva falla aleatoriamente: a veces guarda, a veces lanza 500. Error en logs: 'Deadlock found when trying to get lock'

Cuándo usarlo

Usa /systematic-debugging ante cualquier bug difícil de reproducir, errores intermitentes, problemas de rendimiento o cuando el debugging intuitivo no está dando resultados. El proceso de 4 fases garantiza que se entiende la causa raíz antes de aplicar la solución, lo que evita que el bug vuelva bajo otras condiciones.