[Vibe Coder #5] Leer errores y salir del bucle de la IA

Cuando los mensajes de error rojos cubren la pantalla, el corazón da un vuelco. El inglés es denso, está lleno de palabras desconocidas y parece no explicar qué salió mal. Por eso muchos vibe coders cierran el mensaje sin leerlo y le dicen a la IA: «No funciona, arréglalo». Y la IA empieza a modificar el lugar equivocado.

Aquí está la trampa. Un mensaje de error es, en realidad, la confesión que deja el culpable. Lo que ocurrió y dónde ocurrió ya están escritos. Si sabes leerlo, la mitad está resuelta; si se lo pasas tal cual a la IA, la otra mitad avanza más rápido. En este episodio veremos cómo leer mensajes de error, cómo transmitírselos correctamente a la IA y cómo escapar cuando la IA no consigue corregir el mismo error y sigue dando vueltas.

Estructura de un mensaje de error: solo hay que encontrar tres cosas

Todos los errores tienen la misma estructura. Solo hay que encontrar tres partes.

1. Qué ocurrió (nombre y descripción del error): normalmente es la primera línea. Algo como TypeError: Cannot read properties of undefined. Literalmente, significa «intentó sacar algo de la nada». Es como intentar abrir un paquete que nunca llegó.
2. Dónde ocurrió (archivo y número de línea): si aparece algo como app/page.tsx:42, significa que ocurrió en la línea 42 del archivo app/page.tsx. Ese es el lugar del delito.
3. Por qué ruta ocurrió (stack trace): la lista que aparece debajo es la ruta de llamadas hasta llegar al incidente. No hay que asustarse; basta con saber que las primeras líneas son los registros más cercanos al lugar del delito.

No hace falta entenderlo todo. Con captar solo «qué ocurrió + dónde», ya estás diez veces mejor que quien no lee los errores.

Los errores viven en dos lugares

Aquí vuelve la distinción de la Parte 1. Los errores aparecen en dos lugares, y dónde mirar depende del síntoma.

• Consola del navegador (el grito del frontend): cuando la pantalla queda en blanco, los botones no responden o una parte de la interfaz se rompe. Pulsa F12 en el navegador (o haz clic derecho → Inspeccionar) y abre la pestaña Console.
• Logs del servidor (el grito del backend): cuando fallan el guardado, el inicio de sesión, los pagos o las llamadas a la IA. Durante el desarrollo, aparecen en la terminal donde se ejecuta el programa; después del despliegue, aparecen en el menú Logs del panel del servicio de despliegue visto en la Parte 4.

En pantalla puede aparecer solo «Se produjo un problema», mientras que los logs del servidor contienen la causa real. No mires solo la pantalla para decir «no hay mensaje de error»; acostúmbrate a abrir ambos lugares.

Cómo transmitir errores a la IA: todo el mensaje, junto con el contexto

Cuando encuentres el error, transmíteselo a la IA así.

• Copia el mensaje completo. Las líneas posteriores suelen contener pistas, así que no envíes solo la primera. Es mejor copiar el texto que enviar una captura de pantalla.
• Incluye el contexto. Explica qué estabas haciendo cuando ocurrió, como «después de pulsar el botón de registro», y qué esperabas, como «debería haber ido a la página de bienvenida».
• Indica dónde lo encontraste. ¿Fue «en la consola del navegador» o «en los logs del servidor»? Ese dato reduce a la mitad el área que la IA debe revisar.

La diferencia entre una mala pregunta y una buena es enorme. «No puedo guardar, arréglalo» hace que la IA busque sin mapa. «Al pulsar Guardar, la pantalla no cambia, pero aparece este error en los logs del servidor: (pega el error completo). Debería aparecer una publicación nueva en la lista» le da a la IA el lugar del delito y la confesión.

Cuando la IA da vueltas: 4 formas de escapar

Si la IA no ha podido corregir el mismo error por tercera o cuarta vez, a partir de ahí es más rápido cambiar el juego que aumentar el número de intentos.

1. Abre una conversación nueva. En una conversación llena de intentos fallidos, la IA sigue arrastrada por las hipótesis incorrectas que creó. Abre una conversación nueva y transmite con claridad solo el síntoma y el error actuales; sorprendentemente, muchas veces lo resuelve al primer intento.

2. Haz rollback y vuelve a intentarlo en pasos pequeños. El punto de guardado de la Parte 3 resulta muy útil aquí. Si las modificaciones sucesivas han convertido el código en un parche, vuelve al último commit y pide de nuevo el cambio fallido, en unidades más pequeñas y de una en una.

3. Pide primero una investigación. En vez de «arréglalo», di: «No lo corrijas todavía. Encuentra tres posibles causas de este error y dime cómo verificar cada una». Si le pides que corrija, la IA se precipita; si le pides que investigue, sorprendentemente lo hace con calma. Cuando la causa esté acotada, pídele que haga la corrección: la precisión mejora mucho.

4. Busca el error original. Introduce la primera línea del mensaje de error tal cual en el buscador. Es muy probable que alguien en el mundo ya lo haya sufrido y resuelto. También es potente dar a la IA un enlace de los resultados y pedirle: «Comprueba si esta solución se adapta a mi situación».

Resumen

• Los mensajes de error son confesiones. Con encontrar «qué ocurrió (primera línea) + dónde (archivo:número de línea)», la mitad está resuelta.
• Los errores viven en dos lugares: la consola del navegador (problemas de pantalla) y los logs del servidor (problemas de guardado, inicio de sesión y pagos). Abre ambos.
• Transmite a la IA estas tres cosas juntas: el error completo, qué estabas haciendo cuando ocurrió y dónde lo encontraste.
• Si la IA da vueltas, no aumentes el número de intentos: cambia el juego. Conversación nueva, rollback y pasos pequeños, investigar primero y buscar el error original.

En el próximo episodio veremos un problema clásico que parece un misterio: «Hasta ayer funcionaba, pero hoy no». ¿Por qué deja de funcionar de repente si no tocaste el código? Revisaremos los posibles culpables en orden.

Seguir leyendo

• [Vibe Coder #8] Lista de comprobación de seguridad de 6 puntos antes de aceptar usuarios