Den Post von Marcos Hernanz auf X lesen
Das Reel von @ii.systema ansehen
Ein Reel von @ii.systema sagt, ein Entwickler habe 60 Milliarden Tokens verbraucht und dann die Regeldatei veröffentlicht, die er beim Programmieren mit KI nutzt. Laut dem Reel bringt die Datei das Modell dazu, nach einfachen Lösungen zu suchen, die Dokumentation zu lesen und deine Nutzungslimits zu schonen.
Der Entwickler heißt Marcos Hernanz. Er hat bei Vercel an Next.js gearbeitet. Am 2. August 2026 schrieb er auf X: „After doing ~60B tokens, this is my full AGENTS.md“. Der Post zeigte sieben Regeln. Ein paar Stunden später antwortete er mit einer achten, unter den Worten „Almost forgot“.
Was eine AGENTS.md ist
AGENTS.md ist eine einfache Textdatei im Hauptordner eines Projekts. Coding-Agenten lesen sie, bevor sie loslegen. So schreibst du deine Regeln einmal statt in jedem Chat neu. Claude Code liest sie, wenn das Projekt keine CLAUDE.md-Datei hat.
Die acht Regeln, einfach erklärt
- Halte alten Code nicht am Leben. Wenn etwas ersetzt wird, lösche den alten Weg. Füge keine Fallbacks oder Schichten hinzu, damit er weiter funktioniert.
- Wähle die einfachste Lösung, die die Aufgabe heute vollständig erledigt. Füge keine Einstellungen oder Schichten „für alle Fälle“ hinzu.
- Wachse in kleinen Schritten. Baue zuerst die kleinste Version, die von Anfang bis Ende funktioniert. Füge dann eine Funktion nach der anderen hinzu, auf etwas, das schon funktioniert.
- Halte Teile getrennt. Jeder Teil erledigt eine Aufgabe.
- Nutze eine gute, bekannte Bibliothek, wenn sie die Dinge einfacher oder zuverlässiger macht. Schreibe gängige Funktionen nicht ohne Grund neu.
- Prüfe, was das Projekt schon hat, bevor du ein Paket hinzufügst oder eigenen Code schreibst. Lies die Dokumentation und die Typen der Bibliothek, bevor du entscheidest, dass sie etwas nicht kann.
- Entscheide langfristig. Keine schnelle Notlösung, die später weggeworfen werden soll.
- Bevor du etwas entwirfst, schau dir an, wie gute, etablierte Produkte dasselbe Problem lösen. Übernimm ihre bewährten Muster, statt eigene zu erfinden.
Warum das Tokens sparen kann
Die meisten dieser Regeln sagen dem Agenten, weniger zu schreiben: keine zusätzlichen Schichten, keine Kopien von Bibliotheken, kein Code nur für alte Versionen. Weniger Code heißt weniger zu lesen, zu reparieren und in der nächsten Runde zu erklären. Regel sechs ist die, die das Reel „die Dokumentation lesen“ nennt. Marcos nennt keine Zahl dazu, wie viele Tokens die Datei spart.
Eine Warnung vom Autor
Marcos hat unter seinen Post geschrieben: Er nutzt diese Datei nur für Nebenprojekte, und man sollte sie nicht in Produktion einsetzen, wenn man seine Codebasis nicht zerstören will. Die erste Regel ist die riskante. In einem echten Produkt kann das Löschen alter Wege Nutzer treffen, die sie noch brauchen.
So nutzt du sie
Lege im Hauptordner deines Projekts eine Datei namens AGENTS.md an. Kopiere die acht Regeln aus seinen zwei Posts und ändere jede Regel, die nicht zu deinem Projekt passt. Wenn du Claude Code nutzt und schon eine CLAUDE.md hast, füge ihr eine Zeile hinzu, damit Claude beide liest:
@AGENTS.md