Eine Zeile in AGENTS.md brachte Claude Code und Codex dazu, dem Code statt veralteter Dokumentation zu folgen
Eine Zeile in AGENTS.md brachte Claude Code und Codex dazu, dem Code statt veralteter Dokumentation zu folgen
Forschende zeigten, dass Coding-Agenten oft veraltete Dokumentation befolgen, obwohl sie Widersprüche zum echten Code erkennen. Eine Anweisung in AGENTS.md erhöhte das Befolgen des vorhandenen Codes von 4% auf 91%.
Wenn dein AGENTS.md veraltet ist, kann Claude Code bemerken, dass die Dokumentation nicht mehr zum realen Code passt, und dennoch den alten Anweisungen folgen.
Die Forschenden schufen diese Situation absichtlich und führten 80 Durchläufe durch. In 79 Fällen erkannte Claude Code den Widerspruch, fiel aber trotzdem in die Falle.
Bei Codex war die Lage noch schlechter: In etwa einem von vier Fällen begann Codex, bereits funktionierenden Code umzuschreiben, nur um ihn an die veraltete Dokumentation anzupassen.
Die Korrektur war überraschend einfach. Es reicht, eine Zeile zu AGENTS.md hinzuzufügen. Danach folgten beide Agenten in 91% der Fälle dem vorhandenen Code statt wie bisher in 4%:
„Wenn die Repository-Dokumentation dem vorhandenen Code widerspricht, folge den Konventionen, die im Code selbst etabliert sind, und nenne in der finalen Antwort jede gefundene Abweichung zwischen Dokumentation und Code.“
Warum das wichtig ist
AnalyseVeraltete Anweisungen können die Qualität agentengestützter Entwicklung stillschweigend verschlechtern. Die Priorisierung von Code über Dokumentation hilft Agenten, funktionierendes Verhalten seltener zu brechen und Abweichungen präziser zu melden.
In der Community diskutieren
Teile deine Fragen und Erkenntnisse mit Entwicklern
Verwandt im Ökosystem
Praktische Leitfäden, Terminologie und Agenten-Skills
Claude Code Projects: Wie ein KI-Agent ein Team autonomer Agenten koordiniert
Eine tiefgehende Analyse von Claude Code Projects: die Architektur von Coordinator und Threads, parallele Branches, gemeinsamer Speicher MEMORY.md sowie das Management von Cloud-Agenten.
Codex als Assistent innerhalb von Claude Code: Delegation von Routineaufgaben über Claudex
Die eigentliche Einschränkung bei der Arbeit mit Claude liegt nicht darin, wie gut das Modell schlussfolgert, sondern darin, wie viele Aufgaben im Kontextfenster Platz finden, bevor dieses gefüllt ist.
Claude Code
Der offizielle Terminal-Entwicklungsagent von Anthropic, der direkt in der Befehlszeile über Claude 3.7 Sonnet läuft und native Unterstützung für Bash, Git, Dateisystemzugriff sowie das MCP-Protokoll bietet.
diff-tour wandelt KI-Codeänderungen in eine geführte Review um
diff-tour strukturiert Git-Diffs als schreibgeschützten Durchgang und zeigt, welche Änderungen vor dem Merge von Claude Code oder Codex unbedingt korrigiert werden müssen.
improve-codebase-architecture
Refactor messy codebases into clean, modular, and maintainable layered architectures.
code-review
Official code review capability by @mattpocock. Streamlines autonomous ai-agents tasks and workflows.