So organisieren Sie neuronale Netzwerk-Agenten in Ihrem Projekt ohne Chaos und versehentliches rm -rf

Ein häufiges Problem tritt oft mit autonomen KI-Assistenten im Code auf. Sie geben dem Modell Zugriff auf das Terminal und Dateisystem, bitten es, das Projekt zu erstellen oder einen Bug zu beheben, und ein paar Minuten später beschließt es, den Cache zu bereinigen und löscht etwas Wertvolles. Oder es beginnt zu improvisieren und vergisst völlig die architektonischen Vereinbarungen, die Sie vor einer Stunde besprochen haben.

Das Repository vudovn/ag-kit bietet eine systematische Lösung für dieses Problem. Es ist ein gebrauchsfertiges Set von Verträgen, Regeln und Werkzeugen für die Google Antigravity-Umgebung. Es verwandelt chaotische Interaktionen mit neuronalen Netzwerken in einen vorhersehbaren Prozess mit Rollentrennung und Schutz vor gefährlichen Aktionen.

Was ist im Kit enthalten

Nach der Initialisierung erstellt AG Kit eine Struktur .agents/ im Projektstammverzeichnis. Darin finden Sie deklarative Beschreibungen spezialisierter Rollen, Fähigkeiten, fertiger Workflows und eines Langzeitgedächtnisses.

Wenn ein Projekt in Google Antigravity geöffnet wird, liest die Umgebung diese Konfiguration. Anstatt eines universellen Chat-Bots, der versucht, alles auf einmal zu erledigen, werden Aufgaben an spezialisierte Agenten verteilt.

Das Repository enthält die folgenden Komponenten:

• 20 eng fokussierte Agenten für verschiedene Entwicklungsaufgaben
• 47 Fähigkeiten mit Regeln und Validierungslogik
• 13 fertige Szenarien, die über Slash-Befehle aufgerufen werden
• 6 allgemeine Arbeitsbereich-Regeln
• Langzeit-Gedächtnismodul in .agents/memory/ zur Bewahrung architektonischer Entscheidungen

Schützender Hook für Konsolenbefehle

Der praktischste Teil des Kits ist der eingebaute Interceptor PreToolUse. Bevor ein Befehl im Terminal ausgeführt wird, führt das System ihn durch ein lokales Skript validate-tool-call.mjs.

Wenn ein Agent versucht, rm -rf / auszuführen, die Festplatte zu formatieren oder Systempartitionen zu überschreiben, blockiert das Skript die Ausführung sofort und gibt einen Fehler aus. Routinebereinigungen wie das Entfernen von node_modules oder dist werden hingegen ohne Verzögerung durchgeführt.

Die Hook-Konfiguration wird in .agents/hooks.json definiert:

{
  "enabled": true,
  "PreToolUse": [
    {
      "matcher": "run_command",
      "command": "node .agents/hooks/validate-tool-call.mjs",
      "timeout": 10
    }
  ]
}

Dieser Mechanismus ersetzt keine regulären Berechtigungskontrollen oder Sandboxing, schützt aber vor fatalen Fehlern neuronaler Netzwerke.

Klare Szenarien über Slash-Befehle

Anstatt jedes Mal von Grund auf lange Anweisungen im Chat zu schreiben, bietet das Kit gebrauchsfertige Prozesse. Sie geben einfach einen Slash-Befehl in der Oberfläche ein.

Hier sind einige Beispiele aus den 13 enthaltenen Szenarien:

• /plan erstellt zunächst einen detaillierten Implementierungsplan und eine Checkliste, ohne den Quellcode zu berühren
• /coordinate führt mehrere Rechercheaufgaben parallel aus und erstellt dann eine einheitliche Zusammenfassung
• /debug konzentriert den Agenten darauf, Bug-Ursachen aus Logs und Fakten zu finden, und verbietet wildes Raten
• /remember zeichnet wichtige technische Entscheidungen und Vereinbarungen im permanenten Gedächtnis des Projekts auf
• /verify führt Prüfungen und Tests durch, um zu beweisen, dass der Code tatsächlich funktioniert

Versionierung und sichere Updates

Die Projekt-Ersteller haben Prompts und Regeln wie regulären Quellcode behandelt. Jeder Agent, jedes Szenario und jede Regel hat eine klare semantische Version. Der Zustand des Kits wird in .agents/manifest.json und .agents/manifest.lock.json Dateien erfasst.

Updates werden ebenfalls durchdacht gehandhabt. Der Befehl ag-kit update überschreibt Ihre lokalen Einstellungen nicht. Er führt Änderungen zusammen und erstellt automatisch eine exakte Sicherungskopie im Ordner .ag-kit-backups/.

Wenn ein neues Update etwas kaputt macht, können Sie den vorherigen Zustand mit einem einzigen Befehl wiederherstellen:

ag-kit rollback

So probieren Sie es in Ihrem Projekt aus

Sie benötigen Node.js Version 22 oder neuer und Python 3.10+. Initialisieren Sie in einem bestehenden Repository mit einem einzigen Befehl:

npx @vudovn/ag-kit init

Um zu überprüfen, ob die Konfiguration erfolgreich bereitgestellt wurde und die Hooks funktionieren, enthält das Projekt eingebaute Validierungsskripte:

npm run check:agents
npm run check:antigravity

Sie können den schützenden Hook testen, ohne tatsächlich gefährliche Befehle auszuführen, indem Sie eine Test-Nutzlast direkt an das Validierungsskript senden:

printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

Die Antwort sollte die Meldung BLOCKED by AG Kit anzeigen, und der Prozess sollte mit einem von Null verschiedenen Code beendet werden.

Für wen dieses Tool geeignet ist

AG Kit ist nützlich für Teams und einzelne Entwickler, die Google Antigravity als primäre Umgebung gewählt haben und Ordnung in KI-Workflows bringen möchten. In großen Projekten, in denen der Kontext schnell unübersichtlich wird, spart die strikte Aufteilung in 20 Rollen und das Speichern von Entscheidungen im Gedächtnis considerable Zeit.

Es gibt jedoch eine Einschränkung zu beachten: Die vollständige Kompatibilität ist nur innerhalb von Antigravity gewährleistet. Andere Editoren können die Markup-Dateien in .agents/ lesen, aber Hook-Reaktionen und automatische Weiterleitung funktionieren dort nicht.