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