Warum KI-Coding-Agents bei großen Projekten scheitern: Was 1.281 echte Testläufe zeigen

KI-gestütztes Programmieren verspricht, Entwicklungsprozesse schneller und effizienter zu machen. Doch in der Praxis scheitern viele Agenten, sobald sie mit echten, umfangreichen Codebasen konfrontiert werden.

Eine Auswertung von 1.281 Agenten-Läufen liefert konkrete Hinweise, wo die Probleme liegen und wie Teams sie beheben können.

Das Skalierungsproblem: Komplexität wächst nicht linear

Ein 10.000-Zeilen-Projekt ist nicht einfach zehnmal kleiner als ein 100.000-Zeilen-System. Es ist grundlegend einfacher zu überblicken. Sobald Agenten durch viele Module navigieren, Abhängigkeiten verstehen und Entscheidungen mit weitreichenden Folgen treffen müssen, stoßen sie schnell an Grenzen.

Für große Codebasen braucht es daher intelligente Wege, um den Agenten nur die wirklich relevanten Informationen bereitzustellen.

Fünf häufige Fehlerquellen (und wie man sie vermeidet)

1. Überlastete Kontextfenster

Viele Agenten erhalten nur einen Bruchteil des Codes, den sie eigentlich bräuchten. Eine Funktion ruft zehn weitere auf, aber nur zwei davon sind sichtbar.

Besser funktioniert es, wenn man:

• Code gezielt indexiert und nach Relevanz priorisiert
• Abhängigkeiten bereits vorab kartiert
• Dokumentation als Orientierungshilfe statt als reinen Code-Dump nutzt
• Agenten in spezialisierte Teilagenten aufteilt, die jeweils einen Bereich betreuen

2. Verwirrung durch unklare Bezeichnungen

In großen Systemen treffen unterschiedliche Namenskonventionen und veraltete Muster auf einander. Das führt dazu, dass Funktionen mit gleichem Namen völlig unterschiedliche Aufgaben erfüllen.

Mit folgenden Maßnahmen lässt sich das verringern:

• Eine zentrale Sammlung von Erklärungen zu Architekturentscheidungen anlegen
• Strenge Namensregeln durchsetzen
• Automatisch Architekturentscheidungen dokumentieren
• Agenten gezielt mit den Besonderheiten der eigenen Codebase vertraut machen

3. Falsche Sicherheit und Halluzinationen

Agenten erzeugen oft Änderungen, die auf den ersten Blick plausibel wirken,却 in Wirklichkeit versteckte Einschränkungen ignorieren.

Um das einzugrenzen:

• Automatische Validierungsschritte nach jeder Änderung einbauen
• Static Analysis als laufendes Feedback nutzen
• Vor dem Commit zusätzliche Sicherheitsschritte pr<|eos|>