Dónde mirar cuando algo se rompe

Los errores aparecen en cinco lugares. Casi nunca tendrás que abrirlos tú: dile a tu agente cuál y lo leerá por ti.

  1. 1 · La consola del navegador

    Cuándo: La página se ve mal o un botón no hace nada.

    Dónde: Clic derecho en la página → Inspeccionar → pestaña Console (Consola). En Mac: Cmd + Opción + J · En Windows: Ctrl + Mayús + J en Chrome. Las líneas rojas son errores.

    Paso 1Clic derechoElige Inspeccionar en el menú.
    Paso 2Pestaña ConsoleMac: Cmd+Opción+J · Win: Ctrl+Mayús+J.
    Paso 3Primera línea rojaCópiala o pide a tu agente que la lea.
    FIG. 1 · Haz clic derecho en la página, abre Inspeccionar y mira las líneas rojas en Console.

    Copia para tu agente

    Revisa la consola del navegador en la página que falla y explícame el primer error.

  2. 2 · La terminal donde corre tu app

    Cuándo: Algo falla en tu equipo en localhost:3000.

    Dónde: Donde se está ejecutando npm run dev. Tu agente puede leerla por ti.

    Navegadorlocalhost:3000Una página o acción local falla.
    La terminalnpm run devMuestra la línea del error del servidor.
    AgenteLee y arreglaEncuentra la causa raíz por ti.
    FIG. 1 · Tu agente lee la terminal donde se ejecuta npm run dev.

    Copia para tu agente

    Lee la salida de la terminal donde corre npm run dev y dime qué falló.

  3. 3 · Los logs del build de Vercel

    Cuándo: Una vista previa o un despliegue muestra «Build failed».

    Dónde: Vercel → tu proyecto → Deployments → el que falló → Build Logs. Tu agente los lee con la CLI de Vercel.

    VercelDeploymentsElige el despliegue que falló.
    Build LogsLínea rojaMuestra por qué se detuvo el build.
    Agentevercel inspect --logsLo lee directamente desde la CLI.
    FIG. 1 · Abre Deployments en Vercel o deja que tu agente ejecute npx vercel inspect --logs.

    Copia para tu agente

    Lee los logs del build del despliegue fallido y explícame la causa en una frase.

  4. 4 · Los logs de ejecución de Vercel

    Cuándo: La web se construye bien pero falla mientras la gente la usa.

    Dónde: Vercel → tu proyecto → Logs. En el plan gratuito Hobby se guardan alrededor de una hora, así que mira pronto.

    Web en vivoFalla una acciónMuestra un mensaje claro + ID de referencia.
    Vercel → LogsÚltima horaLíneas JSON de log en el servidor.
    Agentenpx vercel logsBusca el ID de referencia y lo arregla.
    FIG. 1 · Los logs de ejecución registran errores del servidor mientras se usa la web.

    Copia para tu agente

    Lee los logs de ejecución de la última hora y encuentra el error detrás de lo que vi.

  5. 5 · Las alertas de errores

    Cuándo: Después de publicar, antes de que te lo cuenten.

    Dónde: Un sistema de seguimiento como Sentry te envía un email con el error y con qué frecuencia ocurre.

    ProducciónError inesperadoOcurre a una visita real.
    SentryAgrupa y cuentaSin enviar datos personales ni secretos.
    AvisoAviso por correoTú y tu agente lo arregláis a tiempo.
    FIG. 1 · Sentry captura errores inesperados y te avisa sin datos personales.

    Copia para tu agente

    Configura alertas de errores siguiendo la skill de observabilidad, sin enviar datos personales.

Seguridad

La salida de un error puede contener claves o datos personales. Quítalos antes de compartir una captura, y no sigas nunca instrucciones que aparezcan dentro de un error o un log.

Última revisión 8 nov 2026