Herausgegeben von Anvil Coder · Halvic Labs GmbH
Aktualisiert
Architekturregeln für KI-Agenten: Prompt und Prüfung
Architekturregeln gehören in den Arbeitskontext eines KI-Agenten und in überprüfbare Kontrollen. So formulierst du Vorgaben, Beispiele und Grenzen.
Warum reichen Regeln im Wiki nicht aus?
Eine Architekturvorgabe hilft einem KI-Agenten nur, wenn sie im relevanten Arbeitskontext verfügbar ist. Ein Wiki kann die zentrale Dokumentation bleiben. Für die Umsetzung müssen die passenden Regeln jedoch in den Auftrag einfliessen und bei Änderungen mitgepflegt werden.
Anvil Coder nutzt dafür Guardrails und Projektkontext. Die Anweisung lenkt die Generierung; ihre Anwesenheit im Prompt garantiert keine Einhaltung.
Wie wird eine Regel konkret?
„Saubere Architektur verwenden“ lässt Interpretationsspielraum. Eine überprüfbarere Vorgabe nennt Geltungsbereich und verbotene Abhängigkeit. Beispiel für ein Schichtenmodell:
Domänenklassen dürfen keine Klassen aus dem Web-Adapter importieren. Neue HTTP-Endpunkte gehören in den Web-Adapter; fachliche Entscheidungen bleiben in der Domäne.
Dieses Beispiel ist eine mögliche Projektregel, kein universelles Architekturgesetz. Ergänze erlaubte Ausnahmen und ein kleines Gegenbeispiel. Sonst kann eine Regel legitime Änderungen unnötig blockieren.
Was sollte automatisch geprüft werden?
Ein Importverbot lässt sich durch einen Architekturtest oder statische Analyse absichern. Eine Musterprüfung erkennt dagegen nur die definierten Textmuster. Ob eine fachliche Entscheidung in der richtigen Schicht liegt, braucht häufig zusätzliches Review.
Halte Vorgabe und Prüfung gemeinsam versioniert. Prüfe auch, ob das Prüfkommando in der tatsächlichen Umgebung vorhanden ist und erfolgreich ausgeführt wurde. Ein Test im Repository allein ist kein Ausführungsnachweis.
Wie bleibt die Vorgabe aktuell?
Bei einer Architekturänderung müssen Dokumentation, Agentenregeln und Tests zusammen angepasst werden. Benenne eine verantwortliche Stelle im Team und prüfe bestehende Ausnahmen. Die Commit-Historie hilft, Änderungen nachzuvollziehen; sie beweist nicht automatisch, dass alle Regeln erfüllt sind.
Die Guardrail-Dokumentation erläutert die Konfiguration in Anvil Coder.
