agent-bootstrap/rules/AGENTS.md

49 lines
4.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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