Fabien Sanglards agent.md: Stilregeln für KI-Coding-Agenten
Fabien Sanglard hat die agent.md veröffentlicht, die den Code von KI-Agenten deutlich verbessert hat, und erklärt zwei Wege, damit lange Sessions die Regeln nicht aus dem Blick verlieren.
TL;DR
- Fabien Sanglard hat die agent.md veröffentlicht, mit der Coding-Agenten den gewünschten Stil einhalten: keine magischen Zahlen, frühe Returns, vor jedem Bugfix ein Test [^1].
- Die Datei hat den generierten Code deutlich verbessert, ersetzt aber nicht das Lesen, schreibt Sanglard, und in langen Sessions beachtet das Modell sie weniger [^1].
Hintergrund
Coding-Umgebungen laden zu Beginn einer Session eine Anweisungsdatei wie agent.md und fügen sie in den Prompt ein [^1]. Sanglard kam in Etappen dorthin. Ein erster Versuch Mitte 2025 an einer mDNS-Implementierung in Rust lieferte Code, der nicht einmal kompilierte. Im Januar 2026 konnte ein Modell einen komplexen indizierten Binärheap schreiben und einen obskuren Fehler im polling-Crate aufspüren, der von der IOCP-Implementierung unter Windows herrührte, doch der Code war Spaghetti ohne Kommentare und ohne Struktur [^1].
Was passiert ist
Im März 2026 konnte Sanglard mit agentischen IDEs wie Antigravity und dem Claude-Code-Plugin für VS Code über den vorgemerkten Code iterieren, und die Qualität stieg deutlich. Der Haken: Dieselben Review-Kommentare, etwa „keine magischen Zahlen verwenden“, mussten in jeder neuen Session wiederholt werden [^1]. Jeder Vorschlag, den Sanglard immer wieder machen musste, landete in der agent.md, und die so entstandene Datei ist jetzt als Ausgangspunkt öffentlich [^1]. Es sollte reichen, sie ins Wurzelverzeichnis eines Projekts zu legen, und gemini.md oder claude.md lassen sich per Symlink darauf verweisen [^1].
Die Stilregeln verlangen möglichst wenige Worte in Kommentaren, Commit-Nachrichten und Antworten und keine Superlative oder Lobeshymnen: „Hör auf, mir zu sagen, dass ich absolut recht habe.“ Kommentare sollen Was und Warum erklären [^1]. Im Code sollen magische Zahlen und Strings benannten Konstanten oder Enums weichen, Enums statt Booleans als Funktionsparameter dienen, frühe Returns die Einrückung verringern, Funktionsnamen unter 30 Zeichen bleiben und geschweifte Klammern immer stehen, selbst bei einem einzeiligen if [^1].
Andere Regeln betreffen das Design. Felder und Funktionen bleiben privat, solange das Design nichts anderes verlangt, und der Agent muss fragen, bevor er einen Zugriffsmodifikator ändert. Er darf keinen Code anfassen, der nichts mit dem umgesetzten Feature zu tun hat, und jede Schicht darf nur mit der direkt darunterliegenden sprechen [^1]. Commit-Nachrichten folgen sieben Regeln, darunter eine Betreffzeile im Imperativ mit höchstens 50 Zeichen. Bei einem Bugfix schreibt der Agent zuerst den Test, sieht ihn fehlschlagen und schreibt erst dann den Fix [^1].
Warum es wichtig ist
Eine Anweisungsdatei macht aus Review-Kommentaren Voreinstellungen: Ist eine Vorliebe einmal aufgeschrieben, wendet der Agent sie in jeder Session an, statt darauf zu warten, dass jemand sie wiederholt [^1]. Sanglard stellt klar, dass das kein Wundermittel ist. „LLMs halluzinieren ständig und sind nicht vertrauenswürdig“, der Code muss weiterhin geprüft und überarbeitet werden, doch im Review geht es jetzt um Architektur und Design statt um Codestil [^1].
Die Datei hat auch eine Schwachstelle. Sanglard verweist auf die „Kontextverdünnung“, beschrieben im Paper Lost in the Middle: Je länger der Kontext, desto weniger achtet ein Modell auf Anweisungen in der Mitte und desto mehr auf die am Anfang und am Ende [^1]. Die zwei Gegenmittel im Beitrag sind, für jedes Feature eine neue Session zu beginnen und, wenn die Codequalität nachlässt, die Umgebung mit „Reload agent.md“ anzuweisen, die Datei neu zu laden [^1]. Für neue Regeln braucht es nicht einmal einen Editor; Sanglard bittet einfach den Agenten, die agent.md zu ergänzen [^1].
Ein Beispiel aus der Praxis
Angenommen, du sagst deinem Coding-Agenten ständig, er soll frühe Returns verwenden und Code in Ruhe lassen, den er nicht geändert hat. Statt dich zu wiederholen, schreibst du beide Regeln in eine agent.md im Wurzelverzeichnis und verlinkst claude.md per Symlink darauf [^1]. Die nächste Session hält sich von Anfang an daran. Wenn der Agent tief in einer langen Session wieder anfängt, if-Anweisungen zu verschachteln, sagst du ihm, er soll die agent.md neu laden, oder du schließt das Feature ab und öffnest für das nächste eine frische Session [^1].
Passende Produkte
Wir empfehlen dieses Buch, weil es die grundlegenden Software-Design-Prinzipien, den Pragmatismus und die technische Disziplin vermittelt, die erforderlich sind, um klare Grenzen für automatisierte Programmier-Tools zu setzen.