¿Cómo describes un bug a un asistente de IA para que pueda diagnosticarlo con precisión?

Question

Accepted Answer

Un buen informe de bug para una IA es lo mismo que un buen informe de bug para un humano: dale **suficiente contexto para reproducir el problema en su cabeza** y elimina el ruido. La IA solo puede razonar sobre lo que pegas — las descripciones vagas producen conjeturas vagas.

## Qué incluir

- **El mensaje de error exacto y el stack trace completo** — cópialo textualmente, no una paráfrasis. El archivo y la línea en el trace son la pista más útil.
- **El código relevante** — la función que lanza más sus llamadores inmediatos, no todo el repo.
- **Comportamiento esperado vs actual** — "Espero X, pero obtengo Y" es el núcleo de cualquier informe de bug.
- **Pasos de reproducción** — la entrada exacta o secuencia que lo desencadena.
- **Ambiente/versiones** — lenguaje, versiones de framework y bibliotecas (un bug puede ser específico de la versión).
- **Esquema de BD o datos de muestra** — cuando el bug afecta una consulta o forma de datos.

## Qué omitir

Archivos no relacionados, toda tu configuración, secretos/claves API, y teorías "Creo que podría ser X" que sesgan el diagnóstico. Da hechos, no corazonadas.

## Informe débil vs informe fuerte

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

Con la versión fuerte, la IA puede señalar directamente la verificación `undefined` faltante y proponer un guard, porque cada hecho que necesita está en la página.

## Por qué es importante

Un asistente de IA **no tiene acceso a tu sistema en ejecución** — solo razona sobre lo que proporcionas. Un informe débil la obliga a adivinar el error, el código y el entorno a la vez, y una suposición incorrecta desperdicia un viaje de ida y vuelta. Un informe fuerte (trace exacto + código relevante + esperado/actual + pasos de reproducción + versiones) convierte el diagnóstico en una tarea enfocada y usualmente obtiene la corrección correcta en el primer intento. Aprender a escribir informes de bugs ajustados también te hace un mejor debugger, porque te obliga a aislar los hechos antes de preguntar.