ChatGPT · Codex Schritt für Schritt · Kapitel 12 · 4 Min.

AGENTS.md — die Hausregeln

Eine Textdatei im Projektordner, die Codex liest, bevor es anfängt. Damit du dieselbe Ansage nicht jedes Mal wiederholst.

An jeder Baustelleneinfahrt hängt ein Schild. Helmpflicht, Anmeldung im Container, Zufahrt nur über Tor 2. Niemand erklärt das jedem Handwerker einzeln. Es steht da, es gilt, fertig.

Genau das ist AGENTS.md: das Schild am Tor.

Was das ist

Die einfachste Art, eine anzulegen

Nicht selbst tippen. Erzeugen lassen:

/init

Codex sieht sich den Ordner an und schreibt einen ersten Entwurf. Den liest du durch, wirfst raus, was nicht stimmt, und ergänzt, was fehlt. Das ist deutlich schneller, als vor einer leeren Datei zu sitzen.

Was hineingehört

Die Dokumentation nennt sechs Punkte:

• Wie das Projekt aufgebaut ist — welche Ordner wofür da sind.
• Wie man es startet — der Befehl, mit dem es läuft.
• Wie man prüft — Tests, Kontrollen, was nach einer Änderung laufen muss.
• Wie hier gearbeitet wird — Schreibweisen, Gewohnheiten, Reihenfolgen.
• Was nicht passieren darf — die Verbotsliste. Der wertvollste Teil.
• Woran man Erfolg erkennt.

Bei mir steht in der Verbotsliste zum Beispiel, dass eine bestimmte Datei nicht angefasst werden darf, weil sie von Hand gepflegt ist. Das habe ich einmal hingeschrieben und seitdem nie wieder erklärt.

Wo die Datei liegt

Es gibt nicht eine, sondern eine Kette. Codex baut sie bei jedem Start neu zusammen:

1. Deine persönlichen Regeln.
   ~/.codex/AGENTS.md — gilt in jedem Projekt, überall.
2. Die Regeln des Projekts.
   AGENTS.md in der Projektwurzel. Nicht in einem Unterordner, nicht versteckt — direkt daneben.
3. Regeln für einen Unterordner.
   Noch eine AGENTS.md weiter unten, wenn dort etwas anderes gilt.

Zusammengesetzt wird von oben nach unten. Das Nähere sticht: Was im Unterordner steht, schlägt die Projektregel, und die schlägt deine persönliche.

Daneben gibt es AGENTS.override.md. Liegt die in einem Ordner, wird die normale AGENTS.md dort übergangen. Praktisch, um etwas vorübergehend außer Kraft zu setzen, ohne die Datei zu löschen — und ein guter erster Verdacht, wenn plötzlich Regeln gelten, die du nicht kennst.

Die Grenze, die man kennen muss

Achtung

Die Kette wird bei 32 KiB abgeschnitten — und das gilt für alle Dateien zusammen, nicht je Datei. Wer darüber kommt, verliert den Rest, ohne dass es jemand sagt. Das sind ungefähr dreißig Seiten Text; man erreicht es nicht aus Versehen, aber mit einer gewachsenen Sammlung durchaus. Die Grenze lässt sich hochsetzen (project_doc_max_bytes). Besser ist, kurz zu bleiben.

Wenn es doch mehr wird

Es gibt in AGENTS.md keine Möglichkeit, andere Dateien einzubinden. Was du tun kannst: auf sie verweisen.

Bevor du an der Preisliste arbeitest, lies docs/preise.md.
Bevor du Texte schreibst, lies docs/tonfall.md.

Das kostet nichts im Kontext, solange die Dateien nicht gebraucht werden. Der Nachteil ist ehrlich zu benennen: Es ist eine Bitte, keine Garantie. Manchmal liest Codex sie nicht.

Wenn dir das zu wackelig ist, gehört der Ablauf nicht in eine Textdatei, sondern in einen Skill — der wird bei Bedarf verlässlich geladen. Kapitel 15.

Prüfen, ob sie gelesen wurde

Ein einfacher Test: Schreib eine auffällige Regel hinein — etwa, dass jede Antwort mit einem bestimmten Wort beginnen soll. Starte Codex neu und stell eine harmlose Frage.

Kommt das Wort, sitzt die Datei richtig. Kommt es nicht, stimmt der Ordner nicht.

In einem Satz

Kurz und richtig schlägt lang und vollständig. Die Datei wird beim Start gelesen — wer sie ändert, während Codex läuft, muss neu starten.