agent-bootstrap/rules/AGENTS.md

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. 5000–10000ms), 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).