--- title: "AGENTS.md-Generator mit Regeln für fünf Coding-Agenten · DotsAgent" description: "Füllen Sie ein Formular aus und erhalten Sie eine AGENTS.md, dieselbe pfadbezogene Regel für Cursor, Copilot, Claude Code, Cline und Devin sowie Verweisdateien für Gemini CLI und Aider." url: https://dotsagent.io/de/instructions --- Instruct · Tool # AGENTS.md-Generator Füllen Sie ein Formular aus und erhalten Sie eine AGENTS.md mit Ihren Befehlen, Konventionen und festen Grenzen. Zusätzlich erhalten Sie dieselbe pfadbezogene Regel für Cursor, GitHub Copilot, Claude Code, Cline und Devin Desktop sowie Verweisdateien für Tools, die AGENTS.md nicht standardmäßig einlesen. [Wo die einzelnen Tools nach ihren Anweisungsdateien suchen →](https://dotsagent.io/de/instructions/files) `AGENTS.md` ``` # Acme-Web-App Eine Web-App für Kunden mit Admin-Bereich und kleiner REST API. ## Stack Next.js, React, TypeScript, pnpm ## Befehle - Installieren: `pnpm install` - Lokal ausführen: `pnpm dev` - Testen: `pnpm test` - Linting und Typenprüfung: `pnpm lint && pnpm tsc --noEmit` - Build: `pnpm build` ## Code-Stil - Halte dich an die Formatierungsvorgaben des Linters und ändere Dateien nicht, wenn es nicht nötig ist. - Bevorzuge kleine Funktionen mit klaren Ein- und Ausgaben; halte Seiteneffekte an den Rändern. - Frage nach, bevor du eine neue Dependency hinzufügst. - Kommentiere bei nicht offensichtlichem Code die Gründe, nicht die Funktion jeder einzelnen Zeile. ## Tests - Ergänze oder aktualisiere für jedes geänderte Verhalten einen Test. - Führe den Testbefehl aus und behebe alle Fehler, bevor du meldest, dass du fertig bist. - Lösche keinen fehlschlagenden Test und überspringe ihn nicht, damit die Testsuite erfolgreich durchläuft. ## Commits und Pull Requests - Formuliere Commit-Betreffzeilen im Imperativ und mit weniger als 72 Zeichen. - Beschränke jeden Pull Request auf eine Änderung und beschreibe, wie du sie getestet hast. - Führe vor jedem Commit Lint und Tests aus. ## Niemals - Committe niemals Secrets, API-Schlüssel oder .env-Dateien. - Bearbeite generierte Dateien unter src/generated/ niemals manuell; generiere sie stattdessen neu. - Führe niemals destruktive Datenbankbefehle in der Produktionsumgebung aus. - Führe niemals einen Force-Push auf main aus und schreibe niemals gemeinsam genutzte Historie um. ``` ### Dieselbe Regel für fünf Tools Eine Regel in fünf Formaten. Speichere jede Datei unter dem darüber angegebenen Pfad. `.cursor/rules/scoped.mdc` ``` --- description: Konventionen für Dateien, die auf dieses Glob-Muster passen globs: app/**/*.tsx alwaysApply: false --- Halte dich an die Muster, die bereits in benachbarten Dateien in diesem Ordner verwendet werden. Jede exportierte Funktion braucht einen Docstring und einen Test in der passenden Testdatei. ``` `.github/instructions/scoped.instructions.md` ``` --- applyTo: "app/**/*.tsx" --- Halte dich an die Muster, die bereits in benachbarten Dateien in diesem Ordner verwendet werden. Jede exportierte Funktion braucht einen Docstring und einen Test in der passenden Testdatei. ``` `.claude/rules/scoped.md` ``` --- paths: - "app/**/*.tsx" --- Halte dich an die Muster, die bereits in benachbarten Dateien in diesem Ordner verwendet werden. Jede exportierte Funktion braucht einen Docstring und einen Test in der passenden Testdatei. ``` `.clinerules/scoped.md` ``` --- paths: - "app/**/*.tsx" --- Halte dich an die Muster, die bereits in benachbarten Dateien in diesem Ordner verwendet werden. Jede exportierte Funktion braucht einen Docstring und einen Test in der passenden Testdatei. ``` `.devin/rules/scoped.md` ``` --- trigger: glob globs: app/**/*.tsx --- Halte dich an die Muster, die bereits in benachbarten Dateien in diesem Ordner verwendet werden. Jede exportierte Funktion braucht einen Docstring und einen Test in der passenden Testdatei. ``` ## Was eine Anweisungsdatei wirksam macht ### Exakte Befehle weit oben aufführen Führe die tatsächlichen Installations-, Test- und Lint-Befehle samt Flags gleich am Anfang der Datei auf. Benenne den Stack und die Versionen präzise und zeige ein kurzes Codebeispiel, wenn eine Beschreibung in Prosa zu vage wäre. GitHub Blog, Analyse von mehr als 2.500 AGENTS.md-Dateien ### Explizite Verbote formulieren Lege unmissverständlich fest, was der Agent nicht tun darf, etwa Secrets, vendorten Code oder die Produktionsumgebung anzufassen. „Secrets niemals committen“ war die häufigste hilfreiche Einschränkung in den von GitHub untersuchten Dateien. GitHub Blog, Analyse von mehr als 2.500 AGENTS.md-Dateien ### Jede Anweisung überprüfbar machen „Vor dem Commit npm test ausführen“ lässt sich überprüfen, „Änderungen testen“ nicht. Beseitige Widersprüche, denn wenn sich zwei Zeilen widersprechen, kann das Modell einer von beiden folgen. Claude Code Memory-Dokumentation ### Kurz halten und nach Pfad aufteilen Anthropic empfiehlt weniger als 200 Zeilen pro Datei, Cursor weniger als 500 pro Regel. Verschiebe Hinweise für einen bestimmten Bereich in eine pfadbezogene Regel, damit sie nur geladen wird, wenn diese Dateien relevant sind. Imports halten die Datei übersichtlich, senken aber nicht die Kontextkosten. Claude Code Memory-Dokumentation; Cursor Rules-Dokumentation ### Weglassen, was der Agent bereits weiß In einer Studie mit vier Coding-Agenten erhöhten Kontextdateien die Aufgabenerfolgsrate nicht zuverlässig und steigerten die Inferenzkosten um mehr als 20 %. Von LLMs verfasste Dateien wirkten sich leicht negativ aus, und Repository-Übersichten halfen nicht. Beschränke die Datei daher auf nicht offensichtliche Anforderungen, etwa an bestimmte Tools. ETH Zurich SRI Lab, arXiv 2602.11988 ### Regeln ergänzen, wenn sich Fehler wiederholen Fange klein an und ergänze eine Zeile, wenn der Agent denselben Fehler mehr als einmal macht. Verweise auf eine vorhandene Datei als Beispiel, statt einen vollständigen Styleguide einzufügen. Cursor Rules-Dokumentation; GitHub Blog ## Fragen zu AGENTS.md ### Liest Claude Code AGENTS.md? Ja, ab v2.1.277. Standardmäßig liest Claude Code AGENTS.md oder .claude/AGENTS.md nur dann, wenn sich weder im Arbeitsverzeichnis noch in einem übergeordneten Verzeichnis eine CLAUDE.md, .claude/CLAUDE.md oder CLAUDE.local.md befindet. Die Einstellung claude-md-and-agents-md lädt beide Dateien. Eine CLAUDE.md mit @AGENTS.md funktioniert mit jeder Version. ### Braucht AGENTS.md Frontmatter oder bestimmte Überschriften? Nein. AGENTS.md ist eine einfache Markdown-Datei ohne Pflichtfelder; die Überschriften kannst du frei wählen. Die agents.md-Website schlägt Abschnitte wie Projektübersicht, Build- und Testbefehle, Code-Style, Tests, Sicherheitshinweise und Richtlinien für Pull Requests vor. ### Wie verwende ich AGENTS.md in einem Monorepo? Lege eine AGENTS.md im Stammverzeichnis und eine weitere in jedem Paket ab, das eigene Regeln benötigt. Agenten lesen die Datei, die dem bearbeiteten Code am nächsten liegt; bei Widersprüchen gilt diese Datei. Als agents.md dies dokumentierte, enthielt das OpenAI-Hauptrepository 88 solcher Dateien. ### Wie bringe ich Gemini CLI dazu, AGENTS.md zu lesen? Gemini CLI verwendet weiterhin standardmäßig GEMINI.md. Füge AGENTS.md zu context.fileName in .gemini/settings.json hinzu, zum Beispiel ["AGENTS.md", "GEMINI.md"]. Mit /memory show kannst du prüfen, was geladen wurde. ### Welche Coding-Agenten unterstützen AGENTS.md? Wir haben die Dokumentation von OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline und OpenClaw geprüft. Alle lesen die Datei nativ ein. Bei Gemini CLI und Aider ist eine zusätzliche Konfigurationszeile erforderlich. Die Website agents.md führt insgesamt 23 kompatible Tools auf, darunter Zed, Warp, goose, opencode, Jules und JetBrains Junie. ### Wer pflegt das AGENTS.md-Format? OpenAI hat AGENTS.md in die Agentic AI Foundation eingebracht, einen von der Linux Foundation verwalteten Fonds, der am 2025-12-09 zusammen mit MCP und goose angekündigt wurde. Laut der Website agents.md nutzen es mehr als 60k Open-Source-Projekte. Unabhängige Referenz für alle, die KI-Agenten entwickeln. Wir sind mit keinem der hier genannten Anbieter verbunden. © 2026 DotsAgent · Fakten geprüft am 1. Oktober 2026