> ## 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

> Erstellen Sie AGENTS.md-Dateien, um Cascade verzeichnisbezogene Anweisungen bereitzustellen. Die Anweisungen gelten automatisch basierend auf dem Speicherort der Datei in Ihrem Projekt.

`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.

<div id="how-it-works">
  ## Wie es funktioniert
</div>

Wenn Sie eine `AGENTS.md`-Datei (oder `agents.md`) erstellen, erkennt Devin Desktop sie automatisch und übergibt sie an dieselbe [Rules](/de/desktop/cascade/memories#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.

Diese standortbasierte Festlegung des Geltungsbereichs macht `AGENTS.md` ideal, um gezielte Hinweise bereitzustellen, ohne eine einzelne globale Konfigurationsdatei zu überladen.

<div id="creating-an-agentsmd-file">
  ## Eine AGENTS.md-Datei erstellen
</div>

Erstellen Sie einfach eine Datei namens `AGENTS.md` oder `agents.md` im gewünschten Verzeichnis. Die Datei verwendet einfaches Markdown; spezielles Frontmatter ist nicht erforderlich.

<div id="example-structure">
  ### Beispielstruktur
</div>

```
my-project/
├── AGENTS.md                    # Globale Anweisungen für das gesamte Projekt
├── frontend/
│   ├── AGENTS.md                # Anweisungen spezifisch für Frontend-Code
│   └── src/
│       └── components/
│           └── AGENTS.md        # Anweisungen spezifisch für Komponenten
├── backend/
│   └── AGENTS.md                # Anweisungen spezifisch für Backend-Code
└── docs/
    └── AGENTS.md                # Anweisungen für die Documentation
```

<div id="example-content">
  ### Beispielinhalt
</div>

Hier ist eine Beispiel-`AGENTS.md`-Datei für ein Verzeichnis mit React-Komponenten:

```markdown theme={null}
# Komponenten-Richtlinien

Beim Arbeiten mit Komponenten in diesem Verzeichnis:

- Funktionale Komponenten mit Hooks verwenden
- Namenskonvention einhalten: ComponentName.tsx für Komponenten, useHookName.ts für Hooks
- Jede Komponente sollte eine entsprechende Testdatei haben: ComponentName.test.tsx
- CSS-Module für das Styling verwenden: ComponentName.module.css
- Komponenten als benannte Exporte exportieren, nicht als Standard-Exporte

## Dateistruktur

Jeder Komponentenordner sollte enthalten:
- Die Haupt-Komponentendatei
- Eine Testdatei
- Eine Styles-Datei (falls erforderlich)
- Eine index.ts für Re-Exporte
```

<div id="discovery-and-scoping">
  ## Erkennung und Geltungsbereich
</div>

Devin Desktop erkennt `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.md` als auch `agents.md` werden erkannt

<div id="automatic-scoping">
  ### Automatische Festlegung des Geltungsbereichs
</div>

Der Hauptvorteil von `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/**` |

Das bedeutet, dass Sie mehrere `AGENTS.md`-Dateien auf verschiedenen Ebenen haben können, die jeweils immer spezifischere Hinweise für die entsprechenden Verzeichnisse geben.

<div id="best-practices">
  ## Bewährte Vorgehensweisen
</div>

So holen Sie das Beste aus `AGENTS.md`-Dateien heraus:

* **Halten Sie Anweisungen gezielt**: Jede `AGENTS.md` sollte 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.

<div id="content-guidelines">
  ### Inhaltsrichtlinien
</div>

```markdown theme={null}
# Good Example
- Use TypeScript strict mode
- All API responses must include error handling
- Follow REST naming conventions for endpoints

# Less Effective Example
- Write good code
- Be careful with errors
- Use best practices
```

<div id="comparison-with-rules">
  ## Vergleich mit Rules
</div>

Sowohl `AGENTS.md` als auch [Rules](/de/desktop/cascade/memories#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              |

Verwende `AGENTS.md`, wenn du einfache, speicherortbasierte Anweisungen möchtest. Verwende Rules, wenn du mehr Kontrolle darüber brauchst, wann und wie Anweisungen angewendet werden.