| name | debug-forense |
| description | Diagnóstico metódico de bugs. Reproduce, minimiza, formula hipótesis falsificables, instrumenta quirúrgicamente y blinda con test de regresión. |
| license | MIT |
| compatibility | opencode |
🔬 Debug Forense
Diagnostica bugs con método, no con intuición.
Las 6 fases
Fase 1 — Reproducir
Sin reproducción determinista, no sigas. Es perder el tiempo.
- Construye el caso mínimo que dispara el bug
- Confirma que lo ves con tus propios ojos
Fase 2 — Minimizar
Reduce el caso al mínimo absoluto. Elimina todo lo que no sea necesario para reproducir el bug.
Fase 3 — Hipótesis (3-5)
Genera MÚLTIPLES hipótesis, no solo la primera que se te ocurra. Cada hipótesis debe ser falsificable:
"Si X es la causa, entonces cambiar Y hará que el bug desaparezca."
Fase 4 — Instrumentar
Añade logs, breakpoints o assertions en puntos estratégicos. Una variable a la vez — cambiar múltiples cosas destruye la capacidad de diagnóstico.
Fase 5 — Corregir
Aplica el fix mínimo que resuelve la causa raíz. No parches — arreglos.
Fase 6 — Blindar
Escribe un test de regresión que falle sin el fix y pase con él. Así este bug no volverá.
Reglas
- Una variable a la vez. Cambios simultáneos = diagnóstico imposible.
- Sin loop de feedback, no hay diagnóstico. Si no puedes reproducir, no sigas.
- La primera hipótesis suele ser incorrecta. Genera al menos 3.
- Nunca dejes logs de debug en producción.
