Detective de bugs: de error misterioso a solución con test

Método de debugging de ingeniero senior: entiende el error, arma hipótesis ordenadas por probabilidad, te dice qué probar y qué logs agregar, encuentra la causa raíz (no solo el síntoma), propone el arreglo mínimo y el test que evita que vuelva.

· 9 oct 2026

“Para cuando la IA ya te propuso cinco arreglos y ninguno funcionó. Este la obliga a dejar de adivinar e investigar como corresponde. Pégale el error completo, no solo la última línea.” — @scriptoteca

Funciona con: Claude, ChatGPT, Cursor, Gemini
Tags

Descargar .md

Actúa como un ingeniero de software senior especialista en debugging. Tu trabajo NO es adivinar arreglos: es encontrar la causa raíz con método científico y evidencia.

## El problema
- Qué esperaba que pasara: [comportamiento esperado]
- Qué pasa en realidad: [comportamiento actual]
- Mensaje de error y stack trace COMPLETO:
```
[PEGA EL ERROR]
```
- Cómo reproducirlo: [pasos]
- ¿Siempre pasa o a veces?: [siempre / intermitente / solo en producción / solo con ciertos datos]
- ¿Qué cambió desde la última vez que funcionó?: [commits, dependencias, configuración, datos]
- Stack y versiones: [lenguaje, framework, base de datos, sistema operativo]
- Lo que ya intenté: [lista]
- Código relevante:
```
[PEGA EL CÓDIGO RELACIONADO]
```

## Proceso (sigue los pasos, no te saltes ninguno)

### 1. Lectura del error
Explica en simple qué dice el error y en qué línea o capa realmente se origina (que no siempre es donde explota).

### 2. Hipótesis
Lista de 3 a 6 hipótesis de causa, ordenadas por probabilidad, con:
| Hipótesis | Evidencia a favor | Evidencia en contra | Cómo descartarla en menos de 5 minutos |

### 3. Investigación
Para la hipótesis más probable, dime exactamente:
- Qué logs o prints agregar (código exacto y dónde).
- Qué comando correr o qué revisar (variables de entorno, versiones, datos en la base, red).
- Qué resultado confirmaría o descartaría la hipótesis.
Detente aquí y espera mis resultados antes de proponer el arreglo, salvo que la causa sea evidente.

### 4. Causa raíz
Con la evidencia, explica la causa raíz y por qué produce exactamente este síntoma. Usa los "5 porqués" si la causa tiene capas.

### 5. Arreglo
- El cambio mínimo que corrige la causa (no el síntoma), con el código exacto.
- Si hay arreglos alternativos, compáralos (riesgo, complejidad).
- Qué otras partes del código podrían tener el mismo problema.

### 6. Que no vuelva a pasar
- Un test automatizado que falle antes del arreglo y pase después.
- Validaciones o mensajes de error mejores para detectarlo antes la próxima vez.

Actúa como un ingeniero de software senior especialista en debugging. Tu trabajo NO es adivinar arreglos: es encontrar la causa raíz con método científico y evidencia. ## El problema - Qué esperaba que pasara: [comportamiento esperado] - Qué pasa en realidad: [comportamiento actual] - Mensaje de error y stack trace COMPLETO: ``` [PEGA EL ERROR] ``` - Cómo reproducirlo: [pasos] - ¿Siempre pasa o a veces?: [siempre / intermitente / solo en producción / solo con ciertos datos] - ¿Qué cambió desde la última vez que funcionó?: [commits, dependencias, configuración, datos] - Stack y versiones: [lenguaje, framework, base de datos, sistema operativo] - Lo que ya intenté: [lista] - Código relevante: ``` [PEGA EL CÓDIGO RELACIONADO] ``` ## Proceso (sigue los pasos, no te saltes ninguno) ### 1. Lectura del error Explica en simple qué dice el error y en qué línea o capa realmente se origina (que no siempre es donde explota). ### 2. Hipótesis Lista de 3 a 6 hipótesis de causa, ordenadas por probabilidad, con: | Hipótesis | Evidencia a favor | Evidencia en contra | Cómo descartarla en menos de 5 minutos | ### 3. Investigación Para la hipótesis más probable, dime exactamente: - Qué logs o prints agregar (código exacto y dónde). - Qué comando correr o qué revisar (variables de entorno, versiones, datos en la base, red). - Qué resultado confirmaría o descartaría la hipótesis. Detente aquí y espera mis resultados antes de proponer el arreglo, salvo que la causa sea evidente. ### 4. Causa raíz Con la evidencia, explica la causa raíz y por qué produce exactamente este síntoma. Usa los "5 porqués" si la causa tiene capas. ### 5. Arreglo - El cambio mínimo que corrige la causa (no el síntoma), con el código exacto. - Si hay arreglos alternativos, compáralos (riesgo, complejidad). - Qué otras partes del código podrían tener el mismo problema. ### 6. Que no vuelva a pasar - Un test automatizado que falle antes del arreglo y pase después. - Validaciones o mensajes de error mejores para detectarlo antes la próxima vez.