El Stack Trace Decoder: pega cualquier error y obtén la causa raíz + la solución en segundos

El Prompt

Estoy debugueando un error. Ayúdame a entender qué salió mal y cómo solucionarlo.

**Mensaje de error:**
[PEGA EL MENSAJE DE ERROR AQUÍ]

**Stack trace:**
[PEGA EL STACK TRACE COMPLETO AQUÍ]

**Código relevante (la función/archivo donde se origina el error):**
```
[PEGA EL CÓDIGO AQUÍ]
```

**Contexto:**
- Lenguaje/runtime: [ej. Python 3.11, Node.js 22, Go 1.22]
- ¿Qué intentaba hacer cuando ocurrió el error?: [una oración]
- ¿Qué has intentado ya?: [o "nada aún"]

Por favor, proporciona:
1. **Causa raíz** — explica en lenguaje sencillo qué falló realmente y por qué
2. **La solución** — muestra el código corregido con comentarios inline explicando el cambio
3. **Por qué ocurrió** — el mecanismo subyacente o concepto erróneo que causó el bug, para que lo entiendas y no solo copies la solución
4. **Prevención** — una oración sobre cómo evitar este tipo de error en el futuro

Cómo usarlo

Copia la plantilla de arriba. Completa las cuatro secciones — mensaje de error, stack trace, código y contexto. Mientras más completo sea el stack trace, mejor será el diagnóstico. No necesitas editarlo ni limpiarlo; pégalo tal cual.

La sección de contexto es opcional, pero vale la pena llenarla. "¿Qué intentaba hacer?" ayuda al modelo a entender la intención. "¿Qué has intentado ya?" evita que sugiera cosas que ya descartaste.

Lo que obtienes de vuelta

La estructura de respuesta en cuatro partes está diseñada específicamente para evitar los dos modos de falla más comunes de la ayuda con debugging de IA:

• La solución ciega — darte código corregido sin explicar por qué el original estaba mal. Lo aplicas, funciona, pero no lo entiendes y te topas con el mismo patrón en otro archivo la semana siguiente.
• El diagnóstico vago — "parece que podría haber un problema de referencia nula." Sin detalles, sin solución, sin camino a seguir.

El output estructurado fuerza la especificidad: primero la causa raíz (qué está realmente roto), luego la solución con comentarios inline (no solo un volcado de código), luego el mecanismo (el porqué detrás del porqué), y después la prevención (una regla que puedas internalizar).

Funciona en varios lenguajes

Este prompt es agnóstico al lenguaje. Funciona bien con:

• Python — excelente para tracebacks, errores de importación, errores de tipo, problemas con async/await
• JavaScript / TypeScript — maneja errores de Node.js, excepciones de consola del navegador, errores del compilador de TypeScript
• Go — pánicos en runtime, stack traces de goroutines, fallos de aserción de interfaces
• Java / Kotlin — cadenas de NullPointerException, stack traces de la JVM, errores de contexto de Spring
• Rust — mensajes de error del compilador (que ya son detallados pero igual se benefician de una explicación)
• SQL — errores de parseo de consultas, violaciones de restricciones, traces de deadlock de PostgreSQL/MySQL

Para lenguajes compilados donde el stack trace es menos informativo, pega el output completo del compilador junto con el error.

Ejemplo de entrada y salida

Entrada (simplificada):

Mensaje de error: TypeError: Cannot read properties of undefined (reading 'map')

Stack trace:
  at ProductList (ProductList.jsx:14:22)
  at renderWithHooks (react-dom.development.js:14985:18)

Código relevante:
function ProductList({ products }) {
  return (
    <ul>
      {products.map(p => <li key={p.id}>{p.name}</li>)}
    </ul>
  );
}

Contexto: React 18, Node 22. Intentaba renderizar una lista obtenida de una API.

Cómo se ve una buena respuesta:

• Causa raíz: products es undefined cuando el componente se renderiza por primera vez, antes de que llegue la respuesta de la API. .map() no puede ejecutarse sobre undefined.
• Solución: Agrega un valor por defecto — function ProductList({ products = [] }) — o agrega un guardia de nulidad antes del map.
• Por qué ocurrió: React renderiza de forma síncrona antes de que se resuelvan las peticiones asíncronas. El componente se renderiza con el valor inicial que el padre le pase, que es undefined si el padre todavía no ha establecido un estado inicial.
• Prevención: Siempre inicializa las props de tipo lista con un array vacío por defecto y maneja los estados de carga/vacío explícitamente en el componente.

Tips para mejores resultados

• Pega el stack trace completo, no solo la primera línea. Los frames inferiores a menudo revelan la llamada real que disparó el error.
• Incluye el código circundante inmediato, no solo la línea que falló. Un par de líneas de contexto arriba y abajo importan.
• Si el error es intermitente, menciónalo — el modelo considerará condiciones de carrera y problemas de temporización.
• Para errores de TypeScript, incluye las configuraciones relevantes de tsconfig.json si el error es sobre strictness o resolución de módulos.