# Cómo leer un mensaje de error > Un mensaje de error no es una bronca, sino una pista útil con tres partes: la primera línea dice qué falló, el nombre del archivo y el número de línea indican dónde ocurrió y la traza de error lista los pasos previos para que tu agente lo arregle. ## Analogía Piensa en un detector de humo que no solo pita, sino que imprime un recibo que dice: «Tostada quemada — Cocina, ranura 2 de la tostadora — empezó tras poner el temporizador al 9». En cuanto sabes leer ese recibo, las letras rojas dejan de asustar. ## Cómo funciona Cuando algo falla mientras construyes tu app, tu equipo muestra un error-message. Aunque parezca un muro de texto técnico, solo necesitas distinguir tres partes: **qué** falló, **dónde** ocurrió y el **rastro** de pasos que llevó hasta ahí. La **primera línea** te dice **qué** falló, por ejemplo `TypeError: Cannot read properties of undefined (reading 'title')` (la app intentó leer `.title` en algo que estaba vacío). Justo debajo, la ruta de un file con dos números separados por dos puntos —como `app/recipes/page.tsx:24:12`— te dice **dónde**: línea `24`, columna `12` de ese archivo. Las líneas de abajo que empiezan por `at …` forman la stack-trace: el recorrido inverso de los pasos que dio tu app antes de detenerse. No tienes que memorizar ni descifrar cada línea; tu coding-agent lee trazas de error con soltura y las usa para localizar el origen exacto. Para informar bien de un fallo, cuéntale a tu agente tres cosas sencillas —qué hiciste, qué esperabas y qué ocurrió en su lugar— y añade el texto exacto del error o una captura. Antes de pegar o adjuntar nada, comprueba siempre que no se vea ningún secret, contraseña ni api-key; el agente puede leer los archivos de log por su cuenta. ## En tu proyecto Cuando aparezca un error en `localhost:3000` o en la terminal, copia el mensaje (asegurándote de que no incluya claves ni contraseñas) y dile a tu agente qué pulsaste justo antes. Tu agente te explicará el fallo en una frase sencilla antes de arreglarlo. ## Copia para tu agente ```text Pulsé [botón/enlace], esperaba [qué debía pasar] y en su lugar salió este error: [pega el error sin ningún secreto]. Explícame con palabras sencillas qué significan la primera línea y el archivo:línea, y busca la causa. ``` --- Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/como-leer-un-mensaje-de-error) · Licencia: CC BY 4.0