Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
AGENTS.md-Dateien bieten eine einfache Möglichkeit, Cascade kontextabhängige Anweisungen zu geben, die automatisch gelten, je nachdem, wo sich die Datei in Ihrem Projekt befindet. Das ist besonders nützlich, um verzeichnisspezifische Codierrichtlinien, Architekturentscheidungen oder Projektkonventionen festzulegen.
Wie es funktioniert
AGENTS.md-Datei (oder agents.md) erstellen, erkennt Devin Desktop sie automatisch und übergibt sie an dieselbe Rules-Engine, die auch .devin/rules/ (und das ältere .windsurf/rules/) verwendet — nur dass der Aktivierungsmodus hier anhand des Dateispeicherorts statt über frontmatter bestimmt wird:
- Stammverzeichnis: Wird als immer aktiv-Regel behandelt — der vollständige Inhalt wird bei jeder Nachricht in den System-Prompt von Cascade aufgenommen.
- Unterverzeichnisse: Werden als glob-Regel mit einem automatisch generierten Muster
<directory>/**behandelt — der Inhalt wird nur angewendet, wenn Cascade Dateien in diesem Verzeichnis liest oder bearbeitet.
AGENTS.md ideal, um gezielte Hinweise bereitzustellen, ohne eine einzelne globale Konfigurationsdatei zu überladen.
Eine AGENTS.md-Datei erstellen
AGENTS.md oder agents.md im gewünschten Verzeichnis. Die Datei verwendet einfaches Markdown; spezielles Frontmatter ist nicht erforderlich.
Beispielstruktur
Beispielinhalt
AGENTS.md-Datei für ein Verzeichnis mit React-Komponenten:
Erkennung und Geltungsbereich
AGENTS.md-Dateien automatisch in Ihrem gesamten Workspace:
- Workspace-Scan: Alle
AGENTS.md-Dateien in Ihrem Workspace und seinen Unterverzeichnissen werden erkannt - Git-Repository-Unterstützung: Bei Git-Repositories durchsucht Devin Desktop außerdem übergeordnete Verzeichnisse bis zum Git-Root
- Groß-/Kleinschreibung wird nicht beachtet: Sowohl
AGENTS.mdals auchagents.mdwerden erkannt
Automatische Festlegung des Geltungsbereichs
AGENTS.md ist die automatische Festlegung des Geltungsbereichs anhand des Dateispeicherorts:
| Dateispeicherort | Geltungsbereich |
|---|---|
| Workspace-Stammverzeichnis | Gilt für alle Dateien (immer aktiv) |
/frontend/ | Gilt bei der Arbeit mit Dateien in /frontend/** |
/frontend/components/ | Gilt bei der Arbeit mit Dateien in /frontend/components/** |
AGENTS.md-Dateien auf verschiedenen Ebenen haben können, die jeweils immer spezifischere Hinweise für die entsprechenden Verzeichnisse geben.
Bewährte Vorgehensweisen
AGENTS.md-Dateien heraus:
- Halten Sie Anweisungen gezielt: Jede
AGENTS.mdsollte Anweisungen enthalten, die für den Zweck ihres Verzeichnisses relevant sind. - Verwenden Sie eine klare Struktur: Aufzählungspunkte, Überschriften und Codeblöcke erleichtern es Cascade, Anweisungen zu befolgen.
- Seien Sie präzise: Konkrete Beispiele und klare Konventionen funktionieren besser als vage Richtlinien.
- Vermeiden Sie Redundanzen: Wiederholen Sie keine globalen Anweisungen in Dateien von Unterverzeichnissen; diese werden aus übergeordneten Verzeichnissen übernommen.
Inhaltsrichtlinien
Vergleich mit Rules
AGENTS.md als auch Rules geben Cascade Anweisungen, dienen jedoch unterschiedlichen Zwecken:
| Merkmal | AGENTS.md | Rules |
|---|---|---|
| Speicherort | In Projektverzeichnissen | .devin/rules/ (oder das alte .windsurf/rules/) oder global |
| Geltungsbereich | Automatisch anhand des Dateispeicherorts | Manuell (glob, immer aktiv, model decision, manual) |
| Format | Reines Markdown | Markdown mit Frontmatter |
| Am besten geeignet für | Verzeichnisspezifische Konventionen | Übergreifende Aspekte, komplexe Aktivierungslogik |
AGENTS.md, wenn du einfache, speicherortbasierte Anweisungen möchtest. Verwende Rules, wenn du mehr Kontrolle darüber brauchst, wann und wie Anweisungen angewendet werden.