Build-Fehler-Loeser

Das Problem

Build-Fehler sind die Torhueter — nichts wird ausgeliefert, bis sie behoben sind. Aber sie sprechen in kryptischen Meldungen ueber Modulaufloesung, Peer-Dependency-Konflikte, TypeScript-Konfigurationsprobleme und fehlende native Bindings. Eine einzige falsche Version in package.json kann zu 47 Fehlerzeilen kaskadieren. Entwickler verlieren Stunden im Kampf mit Build-Tooling statt Features zu bauen.

Der Prompt

Du bist ein Build-System-Debugging-Experte. Behebe diesen Build-/Kompilierfehler:

BUILD-TOOL: [z.B. Vite 5, Webpack 5, esbuild, tsc, Astro, Next.js]
PAKETMANAGER: [npm/pnpm/yarn + Version]
NODE-VERSION: [z.B. 20.11.1]
OS: [macOS/Linux/Windows]

VOLLSTAENDIGE FEHLERAUSGABE:
[komplette Build-Fehlerausgabe einfuegen — alle Zeilen, nicht nur die erste]

LETZTE AENDERUNGEN:
[was sich vor dem Build-Fehler geaendert hat]

Schritt fuer Schritt beheben:
1. **Fehler-Klassifikation**: Dependency-Resolution, TypeScript-Typfehler, Bundler-Konfiguration, Native-Modul-Build oder Dateisystem-Fehler?
2. **Root-Error-Extraktion**: Build-Fehler kaskadieren — den ERSTEN Fehler in der Ausgabe finden.
3. **Dependency-Graph-Check**: Peer-Dependency-Konflikte, doppelte Pakete oder inkompatible Versionsbereiche?
4. **Konfigurations-Audit**: Relevante Config-Datei auf die Einstellung pruefen, die mit dem Fehler zusammenhaengt.
5. **Loesungsschritte**: Exakte Befehle zur Behebung in der richtigen Reihenfolge liefern.
6. **Verifikation**: Wie bestaetigt man, dass der Fix funktioniert hat?

Beispiel-Ausgabe

Klassifikation: Peer-Dependency-Konflikt — React 19 installiert, Bibliothek erfordert React 18
Root-Error: "Cannot find module 'react-dom/client'" — Bibliothek nutzt React 18-Importpfad
Dependency-Graph: npm ls react zeigt react@19.0.0, aber framer-motion@10.18 erfordert react@^18.0.0
Fix: 1. npm install framer-motion@11 (React 19-kompatible Version)
     2. Oder React 18 pinnen: npm install react@18 react-dom@18
Verifikation: npm run build sollte ohne Fehler abschliessen

Wann verwenden

Diesen Skill einsetzen, wenn der Build-Befehl fehlschlaegt. Funktioniert fuer jedes Build-System. Besonders nuetzlich nach Dependency-Upgrades, Node-Versionswechseln oder beim erstmaligen Klonen eines Repositories.

Profi-Tipps

• Bei TypeScript den LETZTEN Fehler zuerst lesen — tsc gibt Fehler in Dateireihenfolge aus, aber die Ursache ist oft der letzte Fehler.
• node_modules und Lock-File loeschen — rm -rf node_modules package-lock.json && npm install erzwingt eine saubere Aufloesung.
• Auf .npmrc oder .nvmrc pruefen — projektbezogene npm-Config oder Node-Version-Pinning kann globale Einstellungen ueberschreiben.