Resolvedor de Errores de Build

El Problema

Los errores de build son los guardianes — nada se entrega hasta que se resuelvan. Pero hablan en mensajes cripticos sobre resolucion de modulos, conflictos de peer dependencies, desajustes de configuracion TypeScript y bindings nativos faltantes. Una sola version incorrecta en package.json puede cascadear en 47 lineas de error. Los desarrolladores pierden horas peleando con tooling de build en vez de construir features.

El Prompt

Eres un experto en depuracion de sistemas de build. Resuelve este error de build/compilacion:

HERRAMIENTA DE BUILD: [ej. Vite 5, Webpack 5, esbuild, tsc, Astro, Next.js]
GESTOR DE PAQUETES: [npm/pnpm/yarn + version]
VERSION DE NODE: [ej. 20.11.1]
OS: [macOS/Linux/Windows]

SALIDA COMPLETA DEL ERROR:
[pega el error de build completo — todas las lineas, no solo la primera]

CAMBIOS RECIENTES:
[que cambio antes de que se rompiera el build]

Resuelve paso a paso:
1. **Clasificacion del Error**: Es un error de resolucion de dependencias, tipo TypeScript, configuracion del bundler, build de modulo nativo o filesystem?
2. **Extraccion del Error Raiz**: Los errores de build cascadean — encuentra el PRIMER error en la salida que causo todos los siguientes.
3. **Check de Grafo de Dependencias**: Hay conflictos de peer dependencies, paquetes duplicados o rangos de version incompatibles?
4. **Auditoria de Configuracion**: Verifica el archivo de config relevante para la configuracion que se relaciona con este error.
5. **Pasos de Resolucion**: Proporciona los comandos exactos para corregir, en orden.
6. **Verificacion**: Como confirmar que el fix funciono?

Ejemplo de Salida

Clasificacion: Conflicto de peer dependency — React 19 instalado pero libreria requiere React 18
Error raiz: "Cannot find module 'react-dom/client'" — libreria usa path de import de React 18 que cambio en React 19
Grafo: npm ls react muestra react@19.0.0 pero framer-motion@10.18 requiere react@^18.0.0
Fix: 1. npm install framer-motion@11 (version compatible con React 19)
     2. O fijar React 18: npm install react@18 react-dom@18
Verificacion: npm run build deberia completar con 0 errores

Cuando Usar

Usa este skill cuando el comando de build falle. Funciona para cualquier sistema de build. Especialmente util despues de actualizar dependencias, cambiar versiones de Node, o clonar un repositorio por primera vez.

Tips Pro

• En TypeScript lee el ULTIMO error primero — tsc muestra errores en orden de archivo, pero la causa raiz suele ser el ultimo error.
• Borra node_modules y lock file — rm -rf node_modules package-lock.json && npm install fuerza una resolucion limpia.
• Busca .npmrc o .nvmrc — configuracion npm a nivel de proyecto o version de Node fijada pueden sobreescribir tus configuraciones globales.