Zum Inhalt springen
codex-os
Ratgeber

AGENTS.md fuer Codex schreiben

AGENTS.md ist die Projektanleitung fuer Codex. Sie entscheidet, ob der Agent dein Repo versteht, die richtigen Kommandos nutzt und beim Review dieselben Prioritaeten setzt wie dein Team.

MS
Manuel Streit
/ / 3 min Lesezeit

Was in eine gute AGENTS.md gehoert

  • Projektzweck und wichtigste Ordner
  • Build-, Test-, Lint- und Deploy-Kommandos
  • Regeln fuer Dateiaenderungen, Generated Files und User-Changes
  • Review-Guidelines fuer Security, Datenschutz, Performance und UX
  • Konventionen fuer Sprache, Copy, Komponenten und Branching
  • Was Codex niemals ohne Rueckfrage tun darf

Review-Guidelines sind Gold wert

OpenAI dokumentiert, dass Codex bei GitHub Reviews AGENTS.md-Guidelines beachtet. Genau deshalb sollte dort stehen, was fuer dein Repo wirklich P1 ist: Auth-Middleware, PII-Logging, Zahlungslogik, SEO-Crawler, Zugriffsrechte, Migrationen oder UI-Regressions.

Nicht zu lang, nicht zu weich

Eine AGENTS.md ist keine Firmenbibel. Gute Regeln sind konkret, pruefbar und kurz genug, dass ein Agent sie in der Arbeit wirklich nutzt. Fuer Monorepos legen wir zusaetzliche AGENTS.md-Dateien tiefer im Baum an.

Häufige Fragen

Noch offene Punkte?

Schreib uns auf hello@codex-os.de oder buche direkt einen Termin, wir nehmen uns Zeit.

Ist AGENTS.md dasselbe wie CLAUDE.md?
Die Idee ist aehnlich: Projektwissen fuer Agenten. Codex nutzt AGENTS.md als native Projektanweisung.
Braucht jedes Repo eine eigene AGENTS.md?
Ja, mindestens eine kurze. Unterschiedliche Pakete koennen eigene, spezifischere Dateien bekommen.
Kann Codex die AGENTS.md selbst schreiben?
Ja, aber ein Mensch sollte die Regeln reviewen. Gerade Verbote und Review-Prioritaeten muessen stimmen.

Noch Fragen zu AGENTS.md fuer Codex?

Wir beraten ehrlich: 30 Minuten, unverbindlich.

Check buchen

Die Website nutzt nur technisch notwendige Funktionen. Analytics laden wir nur nach Zustimmung. Cal.com fuer die Terminbuchung wird erst geladen, wenn du die Terminbuchung aktiv oeffnest.