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-localstarten .gitlab-ci.ymlundenv/*.generated.envnicht 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:
## 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.