55 lines
3.6 KiB
Markdown
55 lines
3.6 KiB
Markdown
# Agent Instructions
|
|
|
|
## 1. Geltung
|
|
|
|
Diese Datei enthaelt operative Arbeitsregeln fuer Agenten in diesem Repository.
|
|
|
|
|
|
## 2. Codeaenderungen, Commits und Push
|
|
|
|
- Zu jeder Codeaenderung eine Commit-Nachricht vorschlagen.
|
|
- Commit-Nachricht so kurz wie moeglich halten, maximal 120 Zeichen.
|
|
- Gilt fuer jede Sitzung in diesem Repository.
|
|
- Standard-Workflow fuer den Agenten: Nach jeder Codeaenderung automatisch `git add`, `git commit` und `git push` ausfuehren.
|
|
- Ausnahme: Nur dann nicht automatisch committen/pushen, wenn der User es fuer den konkreten Task explizit anders vorgibt.
|
|
- Falls `git push` fehlschlaegt (z. B. Konflikt/Reject), den Fehler sofort melden und kurz den naechsten sicheren Schritt vorschlagen.
|
|
|
|
## 3. Loesungsqualitaet
|
|
|
|
- Konsistente, skalierbare Loesungen umsetzen; keine Hacks oder Quick-Fixes als Endloesung.
|
|
- Grundregel fuer das gesamte Projekt: keine Fallbacks, Ausnahmen oder Workarounds in Applikation, DB oder UI vorsehen oder implementieren.
|
|
- Wenn auf Legacy, Rueckwaertskompatibilitaet oder alte Daten-/UI-/Ablaufvarianten Ruecksicht genommen werden soll, immer zuerst explizit den User fragen und erst nach Freigabe umsetzen.
|
|
- Wir erstellen immer saubere, skalierbare Loesungen fuer das Gesamtsystem und pruefen Integritaet, Konsistenz und Skalierbarkeit, bevor wir Aenderungen oder Erweiterungen umsetzen.
|
|
- Wenn fuer eine robuste Loesung Informationen fehlen, gezielt nachfragen bevor umgesetzt wird.
|
|
|
|
## 4. Lokaler Rechner und DEV-Umgebung
|
|
|
|
- Verbindlich: Lokale Installationen fuer App/Runtime/Scheduler existieren nicht und sind nicht zu verwenden.
|
|
- Verbindlich: Dieses lokale Repository auf dem Mac dient ausschliesslich zum Bearbeiten von Dateien.
|
|
- Verbindlich: DEV-Betrieb ist ausschliesslich auf Synology unter `/volume2/webssd/erpnaurua/dev`.
|
|
- Verbindlich: Fuer DEV-Operationen ist ausschliesslich der Zugang `ssh synology-hz` zu verwenden.
|
|
- Verbindlich: Prozesse, Cronjobs und Runtime-Pruefungen werden nur auf Synology ausgefuehrt, niemals lokal auf dem Mac.
|
|
- Fuer DB-Zugriffe auf DEV immer in diesem Pfad arbeiten und den Command-Prefix verwenden: `bash scripts/db/psql.sh` (DB-Zugangsdaten aus `.env`).
|
|
|
|
## 5. DB-Backups
|
|
|
|
- DB-Backups sind nur fuer Entwickler-DB-Aenderungen (Codex oder Mensch) im Rahmen von Entwicklungsarbeit verpflichtend.
|
|
- In operativen Prozessen/Betriebsablaeufen (App, Workflow, Scheduler, Cron, Runtime) werden niemals DB-Backups ausgefuehrt, auch nicht auf DEV.
|
|
- Fuer verpflichtende Entwickler-Backups auf DEV 20 rollierende Backup-Staende je Backup-Set behalten; aeltere Backups nach erfolgreicher Neuerstellung loeschen.
|
|
|
|
## 6. Runtime-Artefakte
|
|
|
|
- Laufzeitdaten, Logs, Backups, Exporte, PID-Dateien, Heartbeats und sonstige Runtime-Artefakte gehoeren ausschliesslich nach `/runtime/`.
|
|
- `/runtime/` ist bei normaler Code-Entwicklung, Analyse, Review und Refactoring grundsaetzlich zu ignorieren, sofern der User nicht ausdruecklich an Runtime-/Betriebsthemen arbeitet.
|
|
|
|
## 7. Temporaere Migrationsartefakte
|
|
|
|
- Temporaere Migrationsartefakte wie duenne Betriebs-Wrapper sind nur nach expliziter User-Freigabe zulaessig.
|
|
- Solche Artefakte muessen delegierend bleiben, duerfen keine eigene Business-Logik tragen und muessen in `docs/legacy/temporary_migration_artifacts.md` zur spaeteren Entfernung erfasst werden.
|
|
|
|
## 8. Verbindliche Skills und Anleitungen
|
|
- Wenn Prozesse konzipiert werden: verwende immer den Skill prozess-konzeption
|
|
- Wenn Prozesse umgesetzt werden: verwende immer den Skill prozess-umsetzung
|
|
- Wenn UI umgesetzt werden soll: verwende immer den Skill styleguide-anwendung
|
|
- Zwingende Vorgabe für alle Arbeiten ist /docs/technical_architecture.md
|