doppelt.digital Application Platform Dokumentation
English Deutsch

An deinem Projekt arbeiten

Der KI sagen, wie sie arbeiten soll

AGENTS.md und Editor-Regeln: So gibst du allen KI-Tools deines Projekts eigene Arbeitsanweisungen.

Auf dieser Seite

Alle KI-Tools deines Projekts – Cursor, Claude Code, Codex, Antigravity – lesen dieselben Anweisungsdateien. Sie liegen zentral im local-configuration-Repository und gelten per Symlink für das gesamte Projekt. Änderst du sie dort, arbeitet die KI bei allen im Team nach denselben Regeln.

Die Anweisungsdateien

Datei Gilt für
AGENTS.md Alle KI-Tools – der zentrale Ort für deine Regeln
.cursor/rules/*.mdc Nur Cursor (zusätzlich zur AGENTS.md)
CLAUDE.md Nur Claude Code (verweist standardmäßig auf die AGENTS.md)

Was bereits voreingestellt ist

Die generierte AGENTS.md enthält die Plattform-Grundregeln:

  • Anwendungen immer über ap run-local starten.
  • Keine .gitlab-ci.yml-Dateien und keine env/*.generated.env ändern – eigene Werte gehören in env/*.custom.env.
  • Keine Secrets in Dokumentation, Logs, Commits oder Chat-Antworten schreiben.
  • Im passenden App-Repository arbeiten, nicht im local-configuration-Repo.

Eigene Regeln ergänzen

Öffne local-configuration/AGENTS.md und ergänze deine Arbeitsweise als eigenen Abschnitt. Ein bewährtes Beispiel – die KI soll selbstständig committen und pushen:

## 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 im local-configuration-Repository – beim nächsten Klonen/Aktualisieren gilt sie für das ganze Team.

Achtung
Standardmäßig committen und pushen die KI-Tools nicht automatisch – das aktivierst du bewusst über eine solche Regel. Behalte die Kontrolle: Regeln wie „nur auf Feature-Branches" verhindern versehentliche Änderungen an main.

Nützliche Helfer

  • ap git auto-commit – staged, committet und pusht in einem Schritt; praktisch als Befehl, den du der KI in einer Regel an die Hand gibst.
  • Pre-Commit-Hook – die Setup-App installiert ap git pre-commit check als Hook; er blockiert Commits an geschützten Dateien (z. B. generierte Konfiguration), auch wenn die KI sie versehentlich ändert.

Siehe auch