agent-bootstrap/rules/AGENTS.md

50 lines
4.7 KiB
Markdown
Raw Permalink Normal View History

# Antigravity Customization Rules
## Response Formatting Rule
At the beginning of every response to the user, include a timestamp line with the date, the local time (accounting for geographical offset, e.g. Europe/Luxembourg timezone), and `#` followed by a sequential response number.
Example format:
`[19.06.2026 - 06:48:36 (Luxemburg) | #1]`
## Sprache und Anredeform (Language and Tone)
* **Standard-Sprache:** Deutsch (außer vom Benutzer explizit anders gefordert).
* **Anrede:** Verwende für alle Antworten ausschließlich das informelle „Du“ (dein, dir, du). Vermeide jegliche förmliche Ansprache („Sie“, „Ihr“, „Ihnen“).
## Memory-Drift Protokoll (/md)
* Wenn der Benutzer eine Nachricht mit dem Präfix `/md <Begriff>` sendet (z. B. `/md Sie`), bedeutet dies, dass das Modell einen kognitiven Drift erlitten hat.
* **Reaktion:** Das Modell muss sich sofort entschuldigen, die Korrektur annehmen, das gewünschte Verhalten wiederherstellen und ggf. seine Präferenznotizen prüfen.
## Meta-Lernen und Optimierung der Lernstrategien
* **Lernkurvenanalysen:** Das Modell soll regelmäßig versuchen, seine eigenen Lernprozesse und Gedächtnisstrukturen zu verifizieren. Es analysiert, welche Lern- und Speicherstrategien (z. B. direkte Systemprompts vs. Speicherabfragen) am besten performen, um kognitive Drifts zu minimieren.
* **Schwarm-Strategien:** Bei komplexen Aufgaben oder kritischen Alignments prüft das Modell eigenständig, ob der Einsatz von kooperierenden Subagenten (z. B. ein Codierungs-Subagent und ein getrennter Compliance/Watchdog-Subagent zur Qualitätssicherung) eine stabilere und effektivere Performance liefert als ein einzelner Agentenkontext.
## Web-App Deployment & SSL-Automatisierung (Traefik)
* **Regel:** Bei Anfragen zur Veröffentlichung oder zum Deployment von Web-Apps auf dem Zielserver `80.90.43.178` (oder verbundenen Domains) muss automatisch das Traefik-Reverse-Proxy-Routing konfiguriert und das Let's Encrypt TLS-Zertifikat ausgestellt werden.
* **Ablauf:** Nutze dazu den Skill `deploy-with-traefik-ssl`.
## Qualitätssicherung & Verifikationspflicht
* **Regel:** Bevor eine Aufgabe als abgeschlossen gemeldet wird, müssen alle automatisierten Tests (z. B. `npm run build`, API-Verifizierungen oder Unit-Tests) lokal ausgeführt werden. Das Ergebnis dieser Tests muss im Walkthrough dokumentiert werden.
## Session-State-Persistenz
* **Regel:** Pflege am Ende jeder Session den aktuellen Projektzustand, offene To-Dos und wichtige Erkenntnisse in der Datei `.agents/state.json` im Workspace-Verzeichnis.
* **Ablauf:** Lies diese Datei beim Starten eines neuen Projekts oder Chats als erstes ein, um sofort wieder kontextuell synchron zu sein.
## Software- und Bibliotheks-Quarantänepflicht
* **Regel:** Jedes neue Programm, Docker-Image, Third-Party-Skript oder jede Software-Bibliothek, das/die in eines unserer Systeme oder Projekte (z. B. Bernados, u-Topia, Space Agent) integriert wird, muss zwingend zuerst den Quarantäne-Mechanismus durchlaufen.
* **Ablauf:** Vor der produktiven Freigabe oder direkten Systemintegration müssen solche Software-Komponenten in einer isolierten Quarantäne-Umgebung (z. B. auf der dedizierten Proxmox-Quarantäne-VM 81001171 an vmbr4 oder in einem Docker-Container ohne Netzwerkzugriff `--network none` mit Lese-Rechten auf ein absolutes Minimum beschränkt) auf Supply-Chain-Risiken, Backdoors und unerlaubten Datenabfluss analysiert werden.
## Das Staffelstab-Prinzip (Sequentielle Verifikationskoordination)
* **Regel:** Führe niemals Folge-Befehle oder Systemabfragen aus, bevor das Ergebnis des vorherigen Befehls vollständig abgeschlossen und unabhängig verifiziert ist.
* **Ablauf:**
1. Setze einen Befehl ab. Nutze bei `run_command` standardmäßig hohe `WaitMsBeforeAsync`-Werte (z. B. 500010000ms), um Synchronität zu erzwingen.
2. Falls ein Task asynchron im Hintergrund laufen muss, stoppe weitere Toolaufrufe (beende den Turn) und warte passiv auf die System-Benachrichtigung der Fertigstellung.
3. Verifiziere das Ergebnis unabhängig (z. B. per Dateigröße, mtime oder exaktem HTTP-Statuscode), bevor der nächste Schritt eingeleitet wird.
## Proxmox Master-Dateien & Routing-Regel
* **Regel:** Bevor Konfigurationen (insbesondere Traefik-Routing, Nginx-Configs oder Docker-Compose-Dateien) auf Proxmox-VMs editiert werden, muss geklärt werden, ob ein Watcher oder Sync-Daemon (z. B. `lp-manager-worker` auf VM 150) die Replikate steuert.
* **Ablauf:**
1. Prüfe auf Ziel-VMs Mounts und Hintergrundprozesse.
2. Falls ein Synchronisations-Dienst active ist, passe niemals die Datei auf dem Replikat (z. B. Traefik-VM) an, sondern lokalisiere und editiere die Source of Truth (z. B. Master-Datei auf VM 150).