Die tatsächlich geladene Anleitung kennen
Codex liest zunächst globale Regeln und anschließend Projektanweisungen entlang des Pfads bis zum aktuellen Arbeitsverzeichnis. AGENTS.override.md hat an der jeweiligen Stelle Vorrang vor AGENTS.md. Näher gelegene Regeln können frühere ergänzen oder überschreiben. Prüfen Sie bei verschachtelten Projekten deshalb den Startordner und die erkannte Anweisungskette, statt nur die Datei im Repository-Hauptordner zu betrachten.
Kurze Regeln mit überprüfbaren Ergebnissen schreiben
Eine hilfreiche Projektdatei nennt gültige Build- und Testbefehle, wichtige Verzeichnisse und fachliche Abnahmekriterien. Erklären Sie etwa, wie ein Formularfehler reproduziert wird und welche Sprachfassungen geprüft werden müssen. Veraltete Befehle werden entfernt. Lange allgemeine Warnungen helfen wenig, wenn der konkrete nächste Schritt und ein brauchbarer Nachweis fehlen.
Anweisung und Durchsetzung kombinieren
Schreibschutz, Netzwerkgrenzen und Merge-Regeln werden nicht allein durch Text wirksam. Verbinden Sie die Anleitung mit Sandbox, Repository-Schutz und passenden automatischen Prüfungen. Lassen Sie einen neuen Testauftrag die richtige Regel finden und den vorgesehenen Test ausführen. Der Nachweis lautet nicht „AGENTS.md existiert“, sondern dass Regeln, Werkzeuge und tatsächlicher Ablauf zusammenpassen.
Entscheidungsmatrix
| Prüfpunkt | Weiter, wenn | Stoppen, wenn |
|---|---|---|
| Auftrag und Eingaben | Dokumentiert: Scope, Befehle, Tests, Schutzgrenzen und Definition of Done. | Scope, Daten oder Verantwortung sind noch ungeklärt. |
| Wiederholbarkeit | Ein neuer Beispielauftrag findet die zutreffenden Regeln und führt zu den richtigen Testbefehlen sowie einer prüfbaren Abnahme. Übergeordnete und lokale Anweisungen sind im betroffenen Scope widerspruchsfrei. | Es liegt nur eine unbewertete Demo ohne Abnahmenachweis vor. |
| Pflege und Grenzen | Owner, Freigabe, Ersatzweg und nächster Prüftermin sind festgelegt. | AGENTS.md ist eine Anleitung und keine Sicherheitsgrenze. Kritische Rechte und verpflichtende Prüfungen müssen zusätzlich technisch beziehungsweise organisatorisch durchgesetzt werden. |
Nachvollziehbar bleiben
Primärquellen
- OpenAI: Custom instructions with AGENTS.mdQuellenstand:
- OpenAI: Agent approvals and securityQuellenstand:
