Depurar de raíz

Encuentra la causa real de un fallo con una prueba delante, en vez de parchear el síntoma.

Cuándo se usa

Cuando algo falla y la explicación fácil no cuadra, o el mismo fallo vuelve.

SKILL.md

# Depurar de raíz

Un parche que esconde el síntoma cuesta más caro que el fallo, porque vuelve
disfrazado. No propongas ningún arreglo antes de tener la causa demostrada.

## Procedimiento

1. **Reproducir.** Los pasos exactos, el resultado esperado y el que sale de
   verdad. Si no se reproduce, eso es lo primero que hay que resolver.
2. **Aislar.** Reduce el caso hasta el trozo mínimo que sigue fallando. Cada
   pieza que quitas y no cambia nada, deja de ser sospechosa.
3. **Escribir la hipótesis.** Una frase concreta y comprobable. "Algo del estado"
   no vale; "el efecto se ejecuta dos veces porque la dependencia es un objeto
   nuevo en cada render" sí.
4. **Comprobarla.** Con una traza, un punto de parada o una prueba que falle. Si
   la hipótesis no aguanta, vuelve al paso 2 en lugar de retocarla.
5. **Arreglar la causa**, no el punto donde se nota. Si tocas otro sitio para
   compensar, es que la causa sigue ahí.
6. **Dejar la prueba** que falla antes del arreglo y pasa después.

## Cuando la comparación es "allí sí funciona"

Si algo va en otra web o en otro equipo, la diferencia está en el entorno, no en
la lógica. Compara versiones, permisos del navegador, banderas, variables de
entorno y cabeceras. Descarga el HTML del sitio que funciona y míralo: la
respuesta suele estar escrita ahí.

Al terminar, di en dos frases cuál era la causa y cómo se demostró. Si no la
encontraste, dilo claro: una suposición vendida como diagnóstico hace perder más
tiempo que un "no lo sé".