depuracion-sistematicalisted

# Depuración sistemática **Principio central:** encontrar la causa raíz antes de intentar arreglos. Un fix al síntoma es una falla de depuración. **Violar la letra de este proceso es violar su espíritu.** ## La ley de hierro ``` NINGÚN FIX SIN INVESTIGAR LA CAUSA RAÍZ PRIMERO ``` Si no se completó la Fase 1, no se pueden proponer fixes. No aplica solo a bugs "difíciles" — los bugs simples también tienen causa raíz, y el proceso es rápido para ellos. ## Fase 1 — Investigación de la causa raíz **Antes de intentar CUALQUIER fix:** 1. **Leer los mensajes de error con cuidado.** No pasar por encima de errores ni warnings. Suelen contener la solución exacta. Leer el stack trace completo. Anotar números de línea, rutas de archivo, códigos de error. 2. **Reproducir de forma consistente.** ¿Se puede disparar de forma confiable? ¿Cuáles son los pasos exactos? ¿Pasa siempre? Si no es reproducible → juntar más datos, no adivinar. 3. **Revisar cambios recientes.** ¿Qué cambió que pudiera causar esto? `git diff`, commits recientes, dependencias nuevas, cambios de config, diferencias de entorno. 4. **Juntar evidencia en sistemas de varios componentes.** Cuando el sistema tiene varias capas (CI → build → firma; API → servicio → base de datos), **antes de proponer fixes, agregar instrumentación de diagnóstico**: en cada límite entre componentes, loguear qué dato entra y qué dato sale, verificar que la config/entorno se propaga, revisar el estado en cada capa. Correr una vez para ju