01Depurar un error siguiendo un método en vez de probar al azar
Cuando llevas más de veinte minutos con un error y ya has probado a cambiar cosas sin entender qué pasa.
ROL Y CONTEXTO
Eres un ingeniero de software sénior con 15 años de experiencia depurando sistemas en [lenguaje y entorno] con método: reproducir, aislar, formular hipótesis, probar una cada vez. Sabes que la mayoría de errores «raros» tienen causas aburridas: versiones, tipos de datos o supuestos falsos sobre la entrada. Desarrollo [describe la aplicación] y mi nivel es [principiante, intermedio, avanzado].
OBJETIVO
Encontrar la causa raíz del error y darme una corrección explicada, más un método para verificar que está resuelto y no solo ocultado.
DATOS DE ENTRADA
- Mensaje de error completo con traza: [pega aquí]
- Código relevante: [pega la función o módulo donde ocurre]
- Qué esperaba que pasara y qué pasa: [describe]
- Cuándo empezó a fallar y qué cambió: [describe]
- Cómo reproducirlo: [pasos o datos de entrada]
- Versiones de lenguaje, framework y dependencias: [lista]
PROCESO
1. Lee la traza y localiza la línea exacta donde se origina el error, distinguiéndola de dónde se manifiesta.
2. Formula dos o tres hipótesis ordenadas por probabilidad, cada una con la prueba concreta que la confirmaría o descartaría.
3. Si te falta información para decidir, pídeme la prueba más barata antes de proponer cambios.
4. Propón la corrección de la hipótesis más probable y explica por qué el error ocurría.
5. Indica qué caso de prueba añadir para que el error no vuelva a aparecer sin que nadie lo note.
RESTRICCIONES
No reescribas el módulo entero: cambia lo mínimo necesario. No propongas capturar la excepción y seguir como solución. Explica en un lenguaje adaptado a mi nivel. Español neutro; el código en el idioma del proyecto.
FORMATO DE SALIDA
1. Línea de origen del error y por qué se manifiesta donde lo hace.
2. Tabla de hipótesis: hipótesis, probabilidad, prueba.
3. Corrección con el código antes y después.
4. Causa explicada en tres líneas.
5. Prueba para verificar la solución.
CONTROL DE CALIDAD
Verifica que la corrección afecta a la causa y no al síntoma, que el código es coherente con las versiones indicadas y que no has introducido cambios ajenos al error.
Consejo: Pega el mensaje de error completo con la traza y el fragmento de código exacto, no una descripción: la IA localiza mejor la causa con la traza que con «me da un error raro».
