Zum Inhalt springen

Kapitel 2 von 7

Architektur

Code Guardian besteht aus Skills, Hook-Registrierungen, Prüfagenten und Python-gestützten Hook-Skripten, von denen einige einen Vorgang anhalten, bevor er ausgeführt wird. Diese Bausteine spielen bei jedem Aufruf zusammen; diese Seite beschreibt sie und den Ablauf.

Bausteine

Baustein Umfang
Skills 31, code-guardian selbst plus Begleiter
Hook-Skripte 15 Skripte plus 3 Bibliotheken; ihre Regeln stecken in 28 Python-Modulen. Vier davon sperren hart, zwei eingeschränkt, zwei nur nach Zuschaltung; die übrigen geben Hinweise oder sind abgemeldet
Hook-Registrierungen 15 insgesamt: PreToolUse 6, Stop 1, PostToolUse 4, je eine für UserPromptSubmit, SessionStart, SessionEnd und SubagentStop (ohne zugeschaltete Gates; jedes bringt eine Stop-Registrierung hinzu)
Prüfagenten 15, keiner mit Edit- oder Write-Werkzeug
Gates 7: Befund, Entscheidung, Deploy, Daten, Migration, Abhängigkeiten, Recht
Modi 5: Plan, Build, Debug, Cleanup, Data Analytics
Werkzeuge 82 Detektoren und Helfer

Prüfagenten urteilen: Sie haben kein Werkzeug zum Bearbeiten von Dateien und ändern weder Ihren Code noch Ihre Projektdateien. Die einzige vorgesehene Ausnahme ist ihr Beleg, ein Fragment unter .code-guardian-evidence/.

Ablauf eines Aufrufs

  1. Ein Prompt trifft ein. Der UserPromptSubmit-Hook nimmt ihn zuerst entgegen.
  2. Ein Skill wählt den passenden Modus.
  3. Die zuständigen Prüfagenten urteilen.
  4. Befehle laufen durch die PreToolUse-Sperren: verweigern, nachfragen oder zulassen. Dateiänderungen an Zugangsdaten und an den Sperren selbst halten sie nur in unbeaufsichtigten Läufen und im Autopilot an, Entscheidungsfragen nur im Autopilot.
  5. PostToolUse-Hinweise ergänzen das Ergebnis.
  6. Am Antwortende läuft der Stop-Hook. Sperren kann er dort nur mit den zuschaltbaren Prüfungen für Recht und Datenauswertung (Standard aus). Unabhängige Prüfung (ohne den Plan des Autors zu kennen), Befund, Aufgabenliste, Rückblick, Beleg und Auftrag sind Arbeitsanweisung im Skill und halten nicht an.

Die Befehlssperren greifen auch bei MCP-Aufrufen, nicht nur bei den eingebauten Werkzeugen von Claude Code.

Diagramm

Der Weg einer Anfrage durch Code GuardianAblauf: Ihre Anfrage geht durch den Intake, der Skill wählt den Modus, Prüfagenten urteilen. Befehle, Dateiänderungen und Entscheidungsfragen passieren die PreToolUse-Riegel (verweigern, nachfragen, zulassen), danach die PostToolUse-Hinweise, am Ende der Stop-Hook (sperrend nur mit zugeschalteten Gates).Ihre AnfrageIntakeUserPromptSubmitSkill und Modus31 Skills · 5 Modi · 7 GatesPrüfagenten15 Agenten · nur Urteil, kein Edit- oder Write-WerkzeugBelege nach .code-guardian-evidence/WerkzeugaufrufBash, Edit, Write, MCPPreToolUse6 RiegelPostToolUse4 HinweiseAntwortende1 Stop-Hinweisverweigernnachfragenzulassen
Der Weg einer Anfrage durch Code Guardian

In einem Satz

Befehle laufen vor der Ausführung durch Sperren, die verweigern, nachfragen oder zulassen; Skills bestimmen, wie gearbeitet wird, und Prüfagenten urteilen, ohne selbst etwas an Ihrem Code zu ändern.

Dieses Kapitel als Auftrag an Claude Code

Kopieren, die Platzhalter in spitzen Klammern durch Ihre eigenen Angaben ersetzen und in Claude Code einfügen. Der Auftrag ist für Claude Code geschrieben.

Erklär mir anhand der installierten Code-Guardian-Dateien in diesem Projekt, welcher Modus für meine aktuelle Aufgabe zuständig ist und welche Gates dabei greifen.