Agent-Anweisungsdateien
Jeder Coding-Agent lädt vor Arbeitsbeginn eine Projektdatei mit dauerhaften Anweisungen. Hier erfahren Sie, wo die einzelnen Tools suchen, welche Frontmatter-Felder sie verstehen und wie globale, projektweite und verschachtelte Dateien zusammengeführt werden. Abgeglichen mit der Dokumentation der Anbieter am 2026-10-01.
Welches Tool liest welche Datei?
| Tool | Liest | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Nativ |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Nativ |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Nativ |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Nativ |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Per Konfiguration |
| Devin Desktop (früher Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Nativ |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Nativ |
| Aider | .aider.conf.yml | Per Konfiguration |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Nativ |
Verwenden Sie eine einzige AGENTS.md als maßgebliche Quelle und verweisen Sie die übrigen Tools darauf. Sieben der neun oben genannten Tools lesen sie ohne zusätzliche Konfiguration; für Gemini CLI und Aider ist jeweils eine Zeile in der Konfiguration nötig. Eine CLAUDE.md, die nur @AGENTS.md enthält, hält ältere Versionen von Claude Code auf dem gleichen Stand. Verwenden Sie das jeweilige Regel-Format eines Tools nur für pfadbezogene Regeln, die sich nicht in AGENTS.md ausdrücken lassen.
Alle Anweisungsdateien
AGENTS.mdAGENTS.md
AGENTS.md ist eine einfache Markdown-Datei mit Projektanweisungen, die die meisten Coding-Agents ohne zusätzliche Einrichtung lesen. OpenAI hat die Datei der Agentic AI Foundation unter dem Dach der Linux Foundation übergeben. Über 60.000 Open-Source-Projekte verwenden sie.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md ist die Memory-Datei, die Claude Code beim Start aus deinem Home-Verzeichnis, dem Projekt und jedem übergeordneten Verzeichnis lädt. Pfadbezogene Regeln in .claude/rules/ enthalten zusätzliche Hinweise, die nur beim Lesen passender Dateien geladen werden.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md ist die Kontextdatei, die Gemini CLI mit jedem Prompt sendet. Gemini CLI kann auch AGENTS.md oder einen anderen Namen lesen, den Sie in context.fileName festlegen.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Cursor Project Rules sind .mdc-Dateien in .cursor/rules/, deren Frontmatter festlegt, wann die jeweilige Regel eingebunden wird. Cursor liest außerdem AGENTS.md sowie User Rules und Team Rules, die außerhalb des Repositorys festgelegt werden.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot liest eine repositoryweite Datei, .github/copilot-instructions.md, sowie pfadspezifische .instructions.md-Dateien. Außerdem berücksichtigt es AGENTS.md oder alternativ eine einzelne CLAUDE.md- oder GEMINI.md-Datei im Repository-Stammverzeichnis.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
Devin Desktop, seit 2026-06-02 der neue Name für Windsurf, liest Regeldateien aus .devin/rules/ und akzeptiert weiterhin .windsurf/rules/ sowie die veraltete Datei .windsurfrules. Der Trigger jeder Regel legt fest, ob sie immer aktiv ist, anhand eines Globs ausgewählt, vom Modell ausgewählt oder manuell aufgerufen wird.
.clinerules/Cline Rules (.clinerules/)
Cline Rules sind Markdown-Dateien in .clinerules/, die Cline mit globalen Regeln und AGENTS.md zusammenführt. Mit optionalem paths-Frontmatter lässt sich eine Regel auf passende Dateien beschränken.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw erstellt den Kontext jedes Agents aus Markdown-Startdateien in dessen Workspace. Die erforderliche AGENTS.md steht dabei an erster Stelle. Diese Dateien werden beim ersten Zug jeder neuen Sitzung in den System-Prompt eingefügt.