AGENTS.md — Projektregeln
Die Projektregel-Datei, die der Agent bei jedem Turn liest — was hineingehört und warum du sie schreibst, nicht der Agent.
Was ist AGENTS.md?
`AGENTS.md` ist eine normale Markdown-Datei im Wurzelverzeichnis deiner Projektquellen. Sie enthält die Regeln, an die sich der Agent in diesem Projekt halten muss: dein Design-System, Namens- und Code-Konventionen, Architekturentscheidungen, Fachvokabular.
Der Agent liest sie zu Beginn jedes Chat-Turns und stellt sie in seine Anweisungen, unter einer Überschrift, die sie als für das Projekt verbindlich kennzeichnet. Ein frisches Gespräch startet also mit deinen Konventionen, statt sie jedes Mal aus dem Code zu erschließen.
Die Datei gehört dir
AGENTS.md schreibst du. Der Agent legt sie nicht für dich an und bietet es auch nicht an — er liest die Datei, er pflegt sie nicht.
Weil es eine gewöhnliche Datei im Repository ist, ist eine Regeländerung eine Codeänderung: Sie taucht im Diff auf, durchläuft dieselbe Prüfung wie alles andere und ist mit dem Release versioniert, zu dem sie gehört. Auch Monate später zeigt die Historie, welche Regeln galten, als ein Feature entstand.
Was hineingehört
- Design-Tokens und das visuelle System — Palette, Typografie, Radien, Abstände
- Namens- und Code-Konventionen
- Architekturentscheidungen und die Begründung dahinter
- Fachvokabular — was in diesem Produkt eine „Session" oder ein „Mandant" ist
- Fremdsysteme, von denen das Projekt abhängt
Was draußen bleibt
- Zugangsdaten und API-Keys — dafür gibt es Environment-Variablen
- Alles, was sich wöchentlich ändert; Regeln sind für das, was bleibt
- Lange Erklärungen. Die Datei wird bei jedem Turn gelesen, halte sie knapp
Regeln für eine ganze Organisation
`AGENTS.md` gilt für ein Projekt. Im Platform-Builder-Plan kann eine Organisation Regeln einmal für **alle** ihre Projekte setzen — gespeichert an der Organisation, nicht in einem Repository, damit sich kein Projekt still entziehen kann. Siehe Gemeinsamer Kontext & Standards.