KI & Agenten02 / 12
Agent Studio
Ein Claude-Code-Entwicklungsstudio mit deterministischem Routing und harten Prüfstufen
- Status
- Funktionsfähig, nicht veröffentlicht
- Zeitraum
- 2026 →
- Rolle
- Konzeption und Entwicklung, von Anfang bis Ende
- Für
- Internes Werkzeug für meine eigenen Projekte.
Erlebe es
Darstellung echter Werkzeuge: ein geskripteter Durchlauf, keine Aufzeichnung einer Live-Sitzung.
Eine Aufgabe durch das Studio
Aktueller Schritt · Schritt 1 von 16
Request arrives
A task is typed into the session: add a small feature to an existing project.
Nachricht · You → Main agent
Schrittprotokoll
- 01 Request arrives[Nachricht]
- 02 SessionStart injects the project briefing[Hook · erlaubt]
- 03 Main agent plans[Nachricht]
- 04 Delegates a read-only search to Explore[Delegieren]
- 05 Explore reports back[Nachricht]
- 06 Delegates the change to implementer[Delegieren]
- 07 Implementer tries a shell command[Tool-Aufruf]
- 08 guard_bash asks or denies[Hook · blockiert]
- 09 Implementer creates a new file[Tool-Aufruf]
- 10 guard_reuse blocks the duplicate[Hook · blockiert]
- 11 Implementer extends the existing file[Tool-Aufruf]
- 12 Tests run[Tool-Aufruf]
- 13 Stop gate fails[Gate · rot]
- 14 Agent fixes the cause[Tool-Aufruf]
- 15 Stop gate passes[Gate · grün]
- 16 Done[Nachricht]
Problem
Die Arbeit mit KI-Agenten ist unzuverlässig, wenn jede Sitzung Modellwahl, Regeln und Prüfungen neu improvisiert. Die Qualität hängt dann vom Zufall ab und davon, wie sorgfältig der letzte Prompt formuliert war.
Agent Studio ist die Arbeitsumgebung, mit der ich baue: drei Plugins, dreizehn spezialisierte Agenten und sechzehn Skills, verbunden durch Hooks, die schlechte Änderungen stoppen, bevor sie landen.
Fallstudie
Jeder Agent legt Modell und Aufwandsstufe in seiner Definition fest, sodass das Routing Teil des Setups ist und nicht pro Sitzung entschieden wird. Ein Architekt läuft auf Opus mit sehr hohem Aufwand, ein Implementierer auf Sonnet mit mittlerem, ein Schreiber auf Haiku mit niedrigem, und für schwierige Fälle gibt es eine eigene Eskalationsstufe.
Hooks setzen die Regeln durch. Sie lehnen gefährliche Shell-Befehle ab und erzwingen Conventional Commits, halten Geheimnisse und Lockfiles unerreichbar, blockieren doppelte Dateien und Definitionen schon beim ersten Versuch und führen die projekteigenen Lint-, Validierungs- und Testschritte aus, bevor ein Durchgang enden darf.
Architektur
Drei Plugins (studio, studio-web, studio-ai) enthalten Agenten und Skills. Sieben Hook-Registrierungen über fünf Ereignisse setzen die Wächter für Bash, Dateien, Wiederverwendung und das Stop-Gate um, das höchstens drei Versuche erlaubt und nach Platzhaltern sucht.
Technische Entscheidungen
- Modell und Aufwand pro Agent festgelegt, damit Kosten und Qualität vorhersehbar sind.
- Regeln werden von Hooks durchgesetzt, die handeln, nicht von Anweisungen, die das Modell vergessen kann.
- Ein Wiederverwendungs-Wächter, der Duplikate beim ersten Versuch blockiert.
- Autor und Prüfer sind immer verschiedene Kontexte.
Herausforderungen & Abwägungen
Wächter streng genug zu machen, dass sie wirken, ohne dass sie zur Reibung werden. Deshalb begrenzt das Stop-Gate die Wiederholungen, und die Hooks haben eigene Tests.
Belegte Ergebnisse
- 3 Plugins, 13 spezialisierte Agenten, 16 Skills
- 7 Hook-Registrierungen über 5 Ereignisse, 31 Hook-Tests
- Läuft lokal; privat
Die Status sind sachlich: Nichts wird fertiger dargestellt, als es ist.