Ein Entwickler häufte 250 Skills in seinem KI-Agenten an, bevor er beim Ausmisten auf 25 herunterkam. Solche Konfigurationsdateien wachsen unbemerkt, weil Teams bei jedem Fehler eine neue Regel ergänzen und keine wieder streichen. Genau davor warnt Addy Osmani aus dem Claude-Code-Team von Anthropic.
drweb.de als bevorzugte Quelle auf Google hinzufügenQualitätsgeprüfte Inhalte direkt in Google News & DiscoverJetzt hinzufügen
Das Wichtigste in Kürze
- Anweisungen für KI-Agenten haben laut Osmani eine Halbwertszeit: Modelle und Werkzeuge verbessern sich, alte Regeln bleiben als Ballast zurück.
- Untersuchungen an 100 Repositories fanden in fast jeder Agent-Datei Konfigurations-Ballast, darunter 42 Prozent mit Kontext-Überfrachtung und 62 Prozent mit Lint-Resten.
- Anthropic strich für die Claude-5-Reihe über 80 Prozent des Claude-Code-Systemprompts, ohne messbaren Verlust in internen Coding-Tests.
- Osmani rät zu einem Audit alle zwei bis vier Wochen: erst sichern, dann mit /doctor prüfen, testweise entfernen, entscheiden.
Warum veralten die Regeln für KI-Agenten so schnell?
Halbwertszeit statt Dauerregel. Jede Zeile in CLAUDE.md oder AGENTS.md entstand als Reaktion auf einen früheren Fehler des Modells. Sobald ein neues Modell oder ein besseres Werkzeug den Fehler von sich aus vermeidet, bleibt die Anweisung als toter Ballast zurück. Osmani nennt das die Halbwertszeit der Konfiguration.[1]
Ballast kostet doppelt. Wächst eine Datei über die von Anthropic empfohlenen 200 Zeilen hinaus, sinkt die Befolgung, und die Ausgabe wird schlechter. Untersuchungen an 100 Repositories fanden in fast jeder Agent-Datei mindestens einen Konfigurations-Fehler, von Kontext-Überfrachtung bis zu vergessenen Lint-Vorgaben. Ein Test über 288 Läufe und 17 Aufgaben brachte keinen klaren Zugewinn an Korrektheit durch die Anweisungsdateien.
Weniger schlägt mehr. Anthropic entfernte für die Claude-5-Modelle über 80 Prozent des Systemprompts von Claude Code, ohne dass die internen Coding-Tests schlechter ausfielen. Osmani ordnet die Zahl vorsichtig ein: Sie sei kein Zielwert, und die Tests seien nicht öffentlich. Dieselbe Nüchternheit prägt die Debatte um feste Rollen statt immer größerer Kontextfenster.
Eine Konfigurationsdatei ist kein Archiv. Jede Regel, die das Modell längst selbst beherrscht, kostet Tokens und Aufmerksamkeit, ohne einen einzigen Fehler mehr zu verhindern.
— Markus Seyfferth, Chefredakteur Dr. Web
Was bedeutet das Aufräumen für Teams im DACH-Raum?
Fester Ausmist-Rhythmus. Osmani rät zu einem Audit alle zwei bis vier Wochen. Der Ablauf beginnt damit, die Konfiguration zu sichern, danach läuft in Claude Code der Befehl /doctor, der ungenutzte Skills, Plugins und langsame Hooks meldet. Das automatische Gedächtnis prüfen Sie getrennt, weil dort veraltete Vorlieben liegen bleiben.
Testen statt behalten. Verdächtige Einträge entfernen Sie nicht blind, sondern lassen den Agenten dieselbe Aufgabe einmal ohne sie lösen. Bleibt das Ergebnis gleich, war die Regel Ballast. Osmani bringt es auf den Punkt: Ein nützliches Skill zu installieren und es für immer zu behalten seien zwei getrennte Entscheidungen. Wie viel eine gute Oberfläche dabei hilft, zeigt die Diskussion um die richtige Planungsansicht für Agenten.
Governance im Team. Für Agenturen und Mittelständler, die Claude Code, Codex oder Cursor gemeinsam nutzen, wird die Agent-Datei zum geteilten Dokument. Ein versioniertes, regelmäßig ausgemistetes Dokument hält die Token-Kosten niedrig und verhindert, dass widersprüchliche Altregeln die Ausgabe des ganzen Teams verwässern. Ein fester Kalendereintrag alle vier Wochen genügt als Start.
Quelle
[1] Addy Osmani: „Audit your Agent files“
Mehr Newshunger?
- Kontext schlägt Prompt: Die drei Rollen, mit denen Profis KI-Agenten steuern
- KI-Agenten sprengen das Budget: Warum feste Rollen mehr bringen als mehr Rechenleistung
- Planen mit KI-Agenten: Warum Textwände die falsche Oberfläche sind
- MiniMax veröffentlicht seinen Terminal-Coding-Agenten als Open Source
- AX: Googles quelloffener Orchestrator für autonome KI-Agenten
