# Regeln (/de/docs/verdent-manager/configuration/rules)

> Steuerung des Verhaltens von Verdent über Regeldateien



Regeldateien sind Markdown-Dokumente, die festlegen, wie sich Verdent während Coding-Sitzungen verhält. Sie steuern das Verhalten des KI-Agenten, die Ausgabeformatierung und die Einhaltung von Projektstandards.

## Was Sie lernen werden [#was-sie-lernen-werden]

* Verständnis von Benutzerregeln und Projektregeln
* Wann welcher Regeltyp verwendet wird
* Effektive Regeln schreiben

***

## Regeltypen [#regeltypen]

| Regeltyp           | Datei      | Geltungsbereich        | Zweck                              |
| ------------------ | ---------- | ---------------------- | ---------------------------------- |
| **Benutzerregeln** | VERDENT.md | Global (alle Projekte) | Persönliche Coding-Präferenzen     |
| **Projektregeln**  | AGENTS.md  | Aktuelles Projekt      | Teamkonventionen, Projektstandards |

**Speicherort:**

* Benutzerregeln: `~/.verdent/VERDENT.md`
* Projektregeln: `<project>/AGENTS.md`

***

## Benutzerregeln (VERDENT.md) [#benutzerregeln-verdentmd]

Mit Benutzerregeln können Sie das Verhalten von Verdent projektübergreifend anpassen.

**Zugriff:** Einstellungen → Benutzerregeln

**Automatisches Speichern:** Änderungen werden nach 500 ms automatisch gespeichert

<Tabs>
  <Tab title="Zweck">
    * **Coding-Style-Präferenzen:** Einrückung, Namenskonventionen
    * **Framework-Konventionen:** React, Vue, Sprachstandards
    * **Antwortformatierung:** Ausführlichkeit, Erklärungsstil
    * **Persönliche Workflow-Präferenzen:** Tonfall, Kommunikationsstil
  </Tab>

  <Tab title="Beispiel">
    ```markdown
    # User Rules

    ## Code Style
    - Always use TypeScript with strict mode
    - Prefer functional components over class components
    - Use Tailwind CSS for styling
    - Follow the project's existing naming conventions

    ## Communication
    - Provide brief explanations
    - Show code first, explain after
    - Write concise commit messages in conventional format
    ```
  </Tab>
</Tabs>

***

## Projektregeln (AGENTS.md) [#projektregeln-agentsmd]

Projektregeln definieren Standards, die speziell für das aktuelle Projekt gelten. Committen Sie die Datei in die Versionskontrolle, um sie im gesamten Team zu teilen.

**Zugriff:** Bedienfeld „Projekteinstellungen“

**Speicherort:** Projektstammverzeichnis (`<project>/AGENTS.md`)

<Tabs>
  <Tab title="Anwendungsfälle">
    * **Teamkonventionen:** Gemeinsame Coding-Standards
    * **Architektur:** Design-Patterns, State-Management
    * **Tests:** Abdeckungsanforderungen, Frameworks
    * **Workflows:** Build-Befehle, PR-Richtlinien
  </Tab>

  <Tab title="Beispiel">
    ```markdown
    # AGENTS.md

    ## Dev Environment
    - Run `pnpm install` to set up
    - Use `pnpm dev` for local development

    ## Testing
    - Run `pnpm test` before committing
    - Minimum 80% coverage required

    ## PR Guidelines
    - Use conventional commit format
    - Include tests for new features
    ```
  </Tab>
</Tabs>

<Tip>
  Teilen Sie AGENTS.md über die Versionskontrolle mit Ihrem Team, um ein konsistentes KI-Verhalten für alle Teammitglieder zu gewährleisten.
</Tip>

***

## Effektive Regeln schreiben [#effektive-regeln-schreiben]

**Seien Sie konkret:**

```markdown
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions

# Avoid
- Try to use modern JavaScript features
- Add comments when necessary
```

**Best Practices:**

* Verwenden Sie klare, direktive Sprache („Immer …“, „Niemals …“, „Bevorzugt …“)
* Gruppieren Sie zusammengehörige Regeln unter Abschnittsüberschriften
* Halten Sie Regeln knapp (ein Konzept pro Aufzählungspunkt)
* Überprüfen und aktualisieren Sie die Regeln, während sich das Projekt weiterentwickelt

***

## Häufig gestellte Fragen [#häufig-gestellte-fragen]

<AccordionGroup>
  <Accordion title="Wie erstelle ich Regeldateien?">
    Navigieren Sie zu Einstellungen → Benutzerregeln, um `VERDENT.md` für persönliche Präferenzen zu bearbeiten. Erstellen Sie `AGENTS.md` im Stammverzeichnis Ihres Projekts für projektspezifische Regeln. Verwenden Sie einfaches Markdown mit Aufzählungspunkten.
  </Accordion>

  <Accordion title="Wann werden Regeländerungen wirksam?">
    Regeländerungen gelten sofort in neuen Unterhaltungen und wirken sich auf die Antworten der aktuellen Unterhaltung aus.
  </Accordion>

  <Accordion title="Kann ich Regeln vorübergehend außer Kraft setzen?">
    Sie können in Ihrem Prompt konkrete Anweisungen angeben, um Regeln für eine einzelne Anfrage außer Kraft zu setzen.
  </Accordion>
</AccordionGroup>