# Eigene Regeln für KI-Agenten

In der AGENTS.md und den Editor-Regeln aus local-configuration gibst du allen KI-Agenten deines Projekts eigene Arbeitsanweisungen, die für das ganze Team gelten.

> Source: https://www.application-platform.com/de/docs/ai-instructions/

Cursor, Claude Code, Codex und Antigravity lesen dieselben Anweisungsdateien aus `local-configuration`; änderst du sie dort und pushst, gelten sie für alle im Team, sobald Setup-App oder `ap platform projects clone` das Projekt aktualisiert hat.

## Die Anweisungsdateien

| Datei oder Ordner | Gilt für |
|---|---|
| `AGENTS.md` | Alle KI-Agenten; hier stehen deine Regeln |
| `CLAUDE.md` | Claude Code; verweist auf die `AGENTS.md` und ergänzt Claude-spezifische Hinweise |
| `.cursor/rules/*.mdc` | Cursor, zusätzlich zur `AGENTS.md` |
| `.antigravity/` | Antigravity |
| `.claude/`, `.codex/` | Tool-spezifische Konfiguration für Claude Code und Codex |

Eigene Regeln gehören in die `AGENTS.md`; tool-spezifische Dateien änderst du nur für Regeln, die ein einzelnes Werkzeug betreffen.

## Was bereits drinsteht

Die generierte `AGENTS.md` enthält die Plattform-Grundregeln: Start über `ap run-local`, keine Änderungen an `.gitlab-ci.yml` und `env/*.generated.env`, eigene Werte in `env/*.custom.env`, keine Secrets in Dokumentation, Logs, Commits oder Chat-Antworten und Arbeit im passenden App-Repository statt in `local-configuration`. Diese Abschnitte lässt du stehen.

## Eigene Regeln ergänzen

Beschreibe deine Arbeitsweise in einem eigenen Abschnitt von `local-configuration/AGENTS.md`, zum Beispiel damit der Agent selbstständig committet und pusht:

```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 und erstelle nie direkt Commits auf main.
```

Committe und pushe die Änderung in `local-configuration`; beim nächsten Klonen oder Aktualisieren gilt sie für das ganze Team. Standardmäßig committen Agenten nicht von selbst, und die Einschränkung auf Feature-Branches verhindert, dass ein Push auf `main` versehentlich ein Deployment auslöst.

## Helfer rund um Git

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