depurar

• Grupo: Calidad de código
• Cuándo se activa: Algo falla o no funciona (tests en rojo, excepción, error 500, resultado incorrecto): método reproducir, test que falla, hipótesis, acotar y arreglar la causa
• Requiere: code-quality
• Se instala: Siempre: viene en todos los proyectos.

Un bug se arregla entendiéndolo, no probando cambios hasta que deje de fallar. Cambiar cosas al azar arregla el síntoma, esconde la causa y rompe otra cosa. Esta skill se usa en dos momentos:

• Mientras construyes (una función, un endpoint, un componente): en cuanto un test sale en rojo o algo no hace lo esperado, para y aplica el método antes del siguiente cambio.
• Ante un bug reportado (/depurar <síntoma>): el mismo método desde el paso 1.

El método (en orden, sin saltarse pasos)

1. Reproducir: el error exacto (mensaje, traza, entrada que lo provoca). Sin reproducción fiable no se arregla nada: si no se reproduce, lo primero es conseguirlo (datos, pasos, entorno).
2. Test que falla: escribe el test más pequeño que reproduce el bug y comprueba que falla por el motivo correcto. Será la prueba del arreglo y la red contra regresiones.
3. Leer el error de verdad: la traza completa, desde la primera línea del código propio. El mensaje suele decir la causa; léelo antes de formular teorías.
4. Hipótesis explícita: “falla porque X”. Una sola, escrita, con qué la confirmaría o la descartaría.
5. Acotar: divide el problema a la mitad (entrada, capa, commit) hasta aislar dónde nace. Herramientas y técnicas por stack: references/tecnicas-por-stack.md.
6. Arreglar la causa, no el síntoma: el cambio mínimo que la resuelve. Si el arreglo es un try/catch que silencia el error, un if que esquiva el caso o un sleep, casi seguro no es la causa.
7. Verificar: el test del paso 2 en verde, la suite completa en verde (/verificar) y el caso real reproducido del paso 1 funcionando.
8. Documentar: causa en una frase, arreglo y test en el devlog. Si el mismo tipo de bug puede volver en otros sitios, búscalo ahora (mismo patrón en el resto del código).

Lectura mínima por tarea

Tarea	Lee solo
Depuradores, logs temporales y bisección por stack	references/tecnicas-por-stack.md
Síntomas típicos y su causa habitual (no reinventar)	references/sintomas-frecuentes.md

Reglas duras

• Tres intentos fallidos = parar. Si tras tres cambios sigue fallando, la hipótesis es mala: vuelve al paso 3 y 4 con lo aprendido, o pide contexto al usuario. No sigas cambiando cosas.
• Un cambio cada vez, con el test ejecutado después. Varios cambios juntos = no sabes cuál arregló.
• Logs temporales: permitidos durante la depuración con el comentario senzu-allow (el hook de higiene lo exige) y se quitan antes de cerrar.
• No toques el test para que pase. Si el test estaba mal, dilo y explica por qué; si no, el que está mal es el código.
• No desactives la validación, la seguridad ni los tests para “ver si así funciona”.
• Si el bug está en una dependencia: confírmalo con una reproducción mínima fuera del proyecto antes de culparla, y busca si ya está reportado o arreglado en una versión posterior.

Relación con otras skills

• Tests → code-quality/references/testing.md. Errores y logs → code-quality/references/errors-logging.md.
• Bug de rendimiento → code-quality/references/performance.md (medir antes de cambiar).
• Bug que destapa un problema de diseño → anótalo para /auditar o /refactor; no lo arregles de paso.