# Eigene Regeln für KI-Agenten

Die Plattform-Regeln kommen aus dem Agent-Plugin der mp CLI. Projekt-eigene Anweisungen legst du in der AGENTS.md des Anwendungs-Repositories ab.

> Source: https://www.mainpath.ai/de/docs/ai-instructions/

MainPath-Konventionen (Start über `mp run-local`, generierte Dateien, Git und Pipelines) liegen im Agent-Plugin, das `mp agent install` für Cursor, Claude Code und Codex einrichtet. Sie gelten für alle Projekte auf dem Rechner, ohne Dateien in `local-configuration`.

## Was das Plugin schon vorgibt

- Anwendungen über `mp run-local` starten
- `.gitlab-ci.yml` und `env/*.generated.env` nicht von Hand ändern
- eigene Werte in `env/*.custom.env`
- keine Secrets in Dokumentation, Logs, Commits oder Chat-Antworten
- im App-Repository arbeiten, nicht in `local-configuration`
- nach dem Push auf die Pipeline **dieses** Commits warten

Diese Regeln überschreibst du nicht in generierten Dateien. `local-configuration` enthält nur noch Editor-Einstellungen (`.vscode`, `.idea`).

## Projekt-eigene Regeln

Beschreibe die Arbeitsweise deines Teams in einer `AGENTS.md` im **Anwendungs-Repository** (Backend, App oder Homepage), zum Beispiel:

```markdown
## Git-Arbeitsweise

- Erstelle nach jeder abgeschlossenen Aufgabe einen Commit und pushe ihn.
- Nutze Conventional Commits (feat, fix, chore, docs, refactor, test).
- Arbeite auf Feature-Branches (`feat/…`, `fix/…`, `chore/…`), wenn das Team das so hält; sonst auf `main`.
```

Committe und pushe die Datei in diesem Repository; sie gilt für alle, die denselben Code klonen. Tool-spezifische Ergänzungen gehören in `.cursor/rules/` oder `CLAUDE.md` desselben Repositories, nicht in `local-configuration`.

## Helfer rund um Git

`mp git auto-commit` staged, committet und pusht in einem Schritt und eignet sich als Anweisung in einer Regel. Der Pre-Commit-Hook `mp git pre-commit check` der MainPath Toolbox blockiert Commits an geschützten Dateien, auch wenn ein Agent sie geändert hat. Was nach einem Push passiert, steht unter [Git-Workflow und Deployment]({{< relref "git-workflow" >}}).