Communitygithub.com

rjv-gated-build – Gegensprech-Multi-Agenten-Konstruktion

Ein Multi-Agenten-Bauprozess mit unabhängigem Reviewer, der jeden Schritt auf Fehler prüft, bevor er freigegeben wird. Ideal für sicherheitskritische oder finanzielle Systeme, bei denen Fehler teuer sind.

Was ist rjv-gated-build – Gegensprech-Multi-Agenten-Konstruktion?

Der **rjv-gated-build** Skill implementiert einen adversarialen Multi-Agenten-Workflow, bei dem ein unabhängiger zweiter Agent (Reviewer) jeden Schritt des Autors kritisch prüft, bis ein explizites APPROVED erteilt wird. Das Kernprinzip: Qualität entsteht aus Unabhängigkeit – der Reviewer muss mindestens so leistungsfähig sein wie der Autor und idealerweise von einem anderen Modellanbieter stammen, um systematische Blindspots zu vermeiden. Der Workflow gliedert sich in drei Rollen: Orchestrator (hält das Ankerdokument, integriert), Author (erstellt Code/Design) und Reviewer (prüft auf APPROVED). Vor jeder Implementierung wird das Spezifikationsdokument einem intensiven Grill unterzogen, um Designfehler frühzeitig zu erkennen. Der Skill enthält konkrete Regeln für Prompts, Modellökonomie (Flagship nur für wichtige Aufgaben, lokale Modelle für mechanische Arbeit), Überlebensstrategien bei Verbindungsabbrüchen und eine strenge Dokumentenkompression, um Token-Kosten niedrig zu halten. Geeignet für Claude Code, Cursor, Codex und andere Agent-Plattformen mit Subagent-Unterstützung.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add rjvim/ai-skills

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Gated Build – Adversariale Multi-Agenten-Konstruktion

Für Arbeiten, bei denen plausibel falsch teuer ist. Ein Agent – so diszipliniert er auch sein mag – kann seine eigenen Fehler nicht zuverlässig erkennen: Der blinde Fleck, der den Fehler produzierte, begutachtet ihn. Qualität entsteht aus Unabhängigkeit: Ein zweiter Agent, dessen Aufgabe es ist, NO-AGREE zu sagen und jeden Schritt zu hinterfragen, bis er ein explizites APPROVED verdient hat.

Die Ökonomie: Komprimiere alles, was Agenten lesen (Spezifikationen, Notizen, Review-Prompts), damit du dir einen zweiten Agenten leisten kannst, der widerspricht. Effizienz finanziert Redundanz.

1. Rollenbesetzung

Drei Rollen: Orchestrator (hält das Ankerdokument, besetzt die anderen, integriert), Author (erstellt Code/Design), Reviewer (prüft bis APPROVED). Besetzung nach Aufgabe, nicht nach Gewohnheit:

AuthorReviewerWann
Frontier-Agent (voller Repo-Kontext)Cross-Vendor-Frontier-AgentDesign-lastige, hochriskante Builds – das Kernmuster
Externer CLI-Agent (z. B. Codex)Orchestrator selbstMechanische Masseneingabe; Orchestrator hat Kontext + Urteilsvermögen
Lokales Modell (Ollama-Klasse)OrchestratorNull-Kosten-Funktionsentwicklung aus enger Spezifikation
Billig-Tier-SubagentFlaggschiff-TierInnerfamiliäre Ökonomie: billige Hände, teurer Richter

Ausführungsbindungen – jede Besetzung benötigt einen konkreten Transport in deiner Umgebung; verwende, was existiert, anstatt neue Leitungen zu erfinden:

  • Lokaler Modell-Author → der Skill rjv-ollama-delegate (integrierter Runner, Prompt-Schreibregeln, Verifikationsauftrag).
  • Externer CLI-Author/Reviewer (Codex-Klasse) → sein Agent-Plugin oder ein dünner Bash-Forwarder-Subagent (z. B. der Codex-Rettungs-Subagent in Claude Code) – ein Aufruf rein, stdout zurück, günstigstes Modell auf dem Forwarder selbst.
  • Innerfamiliärer billiger Author → Subagent-Spawn mit explizitem Modell (siehe §7).

Trage die Besetzung in den Plan ein. Die Besetzung erfolgt EINMALIG zu Build-Beginn und wird im ## Cast-Abschnitt des Ankerplans festgehalten (siehe rjv-feature-workflow): Orchestrator, Author, Reviewer, Subagent-Tiers, menschliche Gates – mit explizit genannten Modellen. Jede Fortsetzung liest den Cast und spielt ihre Rolle; die Gated-Schleife verhandelt nie neu, wer genehmigt. Eine Neubesetzung ist eine protokollierte Entscheidung mit einem Warum.

Zwei harte Besetzungsregeln (evidenzbasiert, nicht verbiegen):

  1. Der Reviewer muss mindestens so stark sein wie der Author. Die Stärke des Reviewers ist die Quelle der Qualität; die Stärke des Authors ist nur Tippgeschwindigkeit. Ein schwaches Modell reviewt nichts – getestet: Als es gebeten wurde, einen echten Fehler in ausgeliefertem Code zu finden, sagte ein lokales 35B-Modell "keine Fehler".
  2. Bevorzuge Cross-Vendor für das Grillen. Verschiedene Modellfamilien übersehen unterschiedliche Fehlermodi; ein Review innerhalb derselben Familie erbt die blinden Flecken des Authors.

Der Mensch ist auch ein Reviewer. In einem echten Durchlauf entdeckte der Benutzer ein Loch (Broker-Latenz), das BEIDE Frontier-Modelle durch vier Grillrunden hindurch übersehen hatten. Zeige Designs dem Menschen an Phasengrenzen; seine Domänenerfahrung übertrifft die Modell-Priors – wenn seine Live-Evidenz deinem Design widerspricht, wird das Design sofort aktualisiert und sagt dies.

2. Grille die SPEZIFIKATION vor jedem Code

Der Grill mit der höchsten Hebelwirkung findet vor der Implementierung statt. Im Quellprojekt lautete das Round-1-Urteil des Reviewers zum Design: "nicht baubar wie geschrieben" – 10 bewertete Angriffsszenarien, 8 gültig. Die Korrektur vor dem Code kostete die Neufassung eines Dokuments; nach dem Code hätte sie den gesamten Build gekostet.

  • Sende die Spezifikation/das Design an den Reviewer mit: "GREIFE dieses Design an. Liste bewertete Fehlerszenarien auf. Urteil: AGREE / NO-AGREE mit Blockern."
  • Iteriere Spezifikation → Angriff → Änderung bis AGREE. Dokumentiere jede Runde im Ankerdokument (v1 → v2 → v2.1 …) und vermerke, welche Einwände in der Sache akzeptiert und welche mit Begründung abgelehnt wurden.
  • Ein Reviewer, der niemals NO-AGREE sagt, reviewt nicht. Wenn jede Runde sofort zustimmt, schärfe den Prompt (siehe §4) oder besetze neu.

3. Die Gated-Schleife (pro Implementierungsschritt)

Spezifikations-Checkpoint → implementieren → Self-Review + Smoke-Test → REVIEWER-GRILL → korrigieren → erneut grillen … → APPROVED → committen → weiter
  • Spezifikation zuerst. Schreibe die Akzeptanzkriterien des Schrittes VOR der Codierung in das Ankerdokument. Sich selbst gegen eine während des Codierens erfundene Spezifikation zu bewerten, ist wie Fehler zu segnen.
  • Self-Review + Wegwerf-Smoke-Test vor der Übergabe – fange die dummen Fehler günstig, damit die Runden des Reviewers den subtilen gelten.
  • Grille bis zu einem expliziten APPROVED. Ein einziger Round-Trip ist kein Review.
  • Parke, niemals abnicken. Begrenze die Grill-Runden pro Schritt (~6). Immer noch blockiert? Schreibe die offenen Blocker in das Ankerdokument und STOPPE diesen Schritt. Ein bewusstes "geparkt, hier ist der Grund" ist besser als eine vorgetäuschte Genehmigung – nicht verhandelbar, wenn Geld oder Sicherheit auf dem Spiel stehen.
  • Lebendiger Plan / Rückgriffe. Wenn ein Grill einen FRÜHEREN genehmigten Schritt ungültig macht: Öffne ihn erneut, korrigiere, teste erneut, grille erneut, PROTOKOLLIERE den Rückgriff. Ein festgeschriebener falscher Schritt ist schlimmer als ein wieder geöffneter.

4. Den Reviewer antreiben – Prompt-Regeln

  • NUR REVIEWEN. Erste Zeile: "NUR REVIEWEN – keine Dateien ändern, nicht implementieren." Der Reviewer liest, argumentiert, stimmt ab.
  • Du führst die Tests aus, nicht der Reviewer. Die Sandbox des Reviewers hängt bei der Ausführung. Führe die Testsuite selbst aus, füge die Ergebnisse in den Prompt ein ("Suite bereits ausgeführt: N bestanden – Review durch Lesen des Codes"). Dateien lesen ist in Ordnung; Ausführen nicht.
  • Benenne die Fehlermodi. Verweise auf genaue Dateien, den Spezifikationsabschnitt und eine nummerierte Jagdliste. Bei Geldcode: Doppelbelichtung, Überverkauf, verlorene/doppelte Absicht nach Neustart, Reihenfolge-Wettlaufsituationen, Idempotenz, Gebühren/Genauigkeit, den spezifischen riskanten Pfad, der gerade geschrieben wurde. Vage Prompts ergeben vage Reviews.
  • Begrenze jedes Grillen; brich bei Zeitüberschreitung zuerst ab. Hintergrund mit einer Wanduhr-Obergrenze (~12–15 Min.). Bei Zeitüberschreitung: Zuerst den Job ABBRECHEN, prüfen, dass nichts mehr läuft, dann frisch starten. Töte verwaiste Prozesse. Begrenze Neustarts (~3); anhaltende keine-Entscheidung = Tooling-Fehler → parken, nicht faken.

5. Das Ankerdokument (das eigentliche Gedächtnis des Builds)

Ein komprimiertes Arbeitsgedächtnis-Dokument pro Build – und ein Repository hat viele Builds. Führe kein einzelnes globales RESUME.md: Verwende das Layout des rjv-feature-workflow-Skills (.plans/<name>.md pro Arbeitseinheit, verlinkt vom Feature-Roadmap), sodass mehrere Gated-Builds gleichzeitig laufen können und jeder über seinen Namen hydriert wird. Die folgenden Abschnitte leben INNERHALB dieser Plan-Datei. Das Gespräch ist wegwerfbar; das Ankerdokument nicht. "Die Spezifikation ist das einzige Artefakt, das seine Token verdient" (cavekit).

Eigentumsabschnitte – jede Schleifenphase schreibt nur in ihren eigenen:

AbschnittEigentümerEnthält
ZIELMensch + Orchestratorein Absatz, der Punkt, nie vergessen
EINSCHRÄNKUNGEN / VOKABULARMenschvereinbarte Wörter, tote Wörter, harte Grenzen
EVIDENZ-LEDGEROrchestratorLive-Ergebnisse als Design-Einschränkungen – widerlegte Ideen markiert als "nicht wiederbeleben"
INVARIANTENGrill-Rundeneiserne Regeln, die entstanden sind, jede zurückverfolgbar zu einer Runde oder einem Leichnam
DESIGN vNSpezifikations-Grill-Schleifeaktuelles Design + die Grill-Spur (v1 → v2 → …, wer Einwand erhob, was in der Sache akzeptiert wurde)
AUFGABEN / PLANOrchestratorPhasen mit Akzeptanzkriterien; jede Idee bekommt ein ZUHAUSE oder wird getötet
FEHLER / LEICHNAMEImplementierungFehler auf niedrigster Ebene untersucht, taxonomisiert
GRABSTEINEOrchestratorgelöste Fragen, die sichtbar bleiben, "damit niemand sie wieder öffnet"
OFFENjederwirklich unentschiedene Punkte, gekennzeichnet mit USER, wo der Mensch entscheiden muss

Aufzeichnungsregel – nach Zielgruppe komprimieren:

  • Alles, was Agenten lesen (dieses Dokument, RESUME, Grill-Prompts, Gedächtnis): Höhlenmenschen-Register. Fakten, Datei:Zeile, Imperative. "Register order BEFORE send (sync fill drop → oversell)" – keine Prosa. Geschrieben für einen Leser ohne Kontext und 10 Sekunden. ~75% günstiger bei jedem erneuten Lesen, und erneutes Lesen sind die wiederkehrenden Kosten.
  • Alles, was Menschen lesen (Antworten, benutzerorientierte Dokumente): normale Prosa, konkrete Beispiele mit Zahlen. Verständnisfehler kosten mehr als Ausgabe-Token.
  • Die Zwei-Zielgruppen-Trennung ist explizit: Agenten-Notizen werden nur dann zu benutzerorientierten Dokumenten, wenn sie konkret und vereinbart sind.

Die Kein-später-Regel. Verschiebe niemals etwas auf "später". Jede Idee bekommt ein Zuhause in einer benannten Phase (mit Begründung, warum dort) oder wird getötet. Im Quellprojekt verbarg "später" das wertvollste Experiment – es wurde zum ERSTEN Build-Element, sobald es aufgetaucht war. Einzige akzeptable Verschiebung = eine echte strukturelle Abhängigkeit, die benannt ist.

Komprimierungswartung. Das Ankerdokument und die Gedächtnisdateien werden bei jeder Wiederaufnahme erneut gelesen – sie sind wiederkehrende EINGABEKosten, die teuren. Schreibe sie periodisch (am Ende einer Phase oder wenn das Dokument aufbläht) im Register neu: entferne Prosa, behalte Fakten. Komprimierungsregeln: niemals Zahlen, Bezeichner, Datei:Zeile-Referenzen, Code, Befehle oder Fehlertexte anrühren (bytegenau); niemals die Bedeutung des EVIDENZ-LEDGERS komprimieren – eine verlorene Nuance dort eröffnet eine widerlegte Idee erneut. Überholte Design-Abschnitte schrumpfen zu einzeiligen Grabsteinen; die Grill-Spur behält nur Runde + Urteil + was sich geändert hat.

6. Am Leben bleiben – der Durchlauf muss Unterbrechungen überleben

Zwei Fehlermodi WERDEN bei einem langen Durchlauf auftreten: Der Reviewer hängt, und deine eigene Verbindung bricht mitten in der Antwort ab. Die Verteidigung ist dieselbe: halte den Zustand niemals nur im Live-Gespräch.

  • Fortsetzungszeiger + Abgleich bei Wiedereröffnung. Der Abschnitt Nächste Schritte des Ankerdokuments wird am ENDE jedes Schrittes neu geschrieben: aktueller Schritt + Status, genaue nächste Aktion, Muss-lesen-Dateien, harte Regeln. Bei jeder Wiederaufnahme – nach Komprimierung, nach Unterbrechung, geplantem Aufwachen – ERSTE Handlung ist der rjv-feature-workflow-Abgleichsritus: lies den Plan → ÜBERPRÜFE jede "erledigt"-Behauptung gegen echten Code/Datenbank → notiere Abweichungen → schreibe Nächste Schritte neu → stempel "Zuletzt abgeglichen" → dann handle. Vertraue niemals einem veralteten Häkchen; eine Unterbrechung kann die Bearbeitung verloren haben, die ein Häkchen behauptet.
  • Comitte früh und oft. Jeder genehmigte Schritt wird sofort committed. Eine Unterbrechung kostet dann höchstens die laufende Bearbeitung, nicht eine Nacht Arbeit.
  • Plane eigene Aufwachvorgänge. Wenn du an ein begrenztes Grillen übergibst, plane einen Selbstaufwacher (~15 Min.) ein, sodass du AKTIV zurückkehrst – passive "der Job wird mich schon wieder aufrufen"-Wächter können still sterben.
  • Idempotente Schritte. Du kannst mitten in einem Schritt nach einer Unterbrechung wieder eintreten; mache Nebenwirkungen sicher wiederholbar (Dedup-Keys, Upserts, Bereits-erledigt-Prüfungen).

7. Modellökonomie – verbrenne das Flaggschiff nicht für alles

Lange Durchläufe scheitern an Budget-/Ratenlimits, bevor sie an der Schwierigkeit scheitern. Vollständigkeit hängt von Sparsamkeit ab:

  • Standardmäßig billig. Kleines/schnelles Modell für mechanische Subagenten (der Reviewer-FORWARDER ist ein Bash-Aufruf – gehe zum günstigsten; die Qualität des Grills ist das Modell des REVIEWERS, nicht das des Forwarders). Mittlere Stufe für Routine-Code und Analyse.
  • Lokale Modelle für spezifikationsimplementierbare Funktionen – null Kosten, und aus einer engen Spezifikation erreichen sie ~90% Produktionsqualität. Niemals als Reviewer (harte Regel 1). Siehe den Skill rjv-ollama-delegate.
  • Reserviere das Flaggschiff für Design, Synthese, endgültiges Urteil und das Grillen selbst.
  • Setze das Modell EXPLIZIT pro Subagent – niemals standardmäßig das teure Elternmodell erben.

8. Umfangsehrlichkeit – besonders bei Finanzsystemen

Sage klar, was "erledigt" bedeutet. "Reviewer-APPROVED bis Schritt N" ≠ "gegen die reale Welt validiert", wenn der Durchlauf nur einen Simulator/Papier-Pfad geübt hat. Halte gefährliche Gates – Live-Handel, Produktions-Deployments, destruktive Operationen – physisch ausgeschaltet, bis eine separate, explizite Validierungsphase mit eigenem Gate (Papier-Parität, Fill-Ratio-Bänder, Fail-Closed-Schwellen) stattgefunden hat. Lasse niemals zu, dass "genehmigt" als "sicher zu versenden" gelesen wird.

Anhang – wenn der Reviewer OpenAI Codex CLI ist

Schwer erkämpfte operative Details für das Antreiben von Codex als Grill:

  • Zuerst abbrechen, niemals wieder anhängen. Bei einer Grill-Zeitüberschreitung NICHT "wieder anhängen, um seine Arbeit zu erhalten" – das Wiederanhängen kann sofort und still sterben und dich ohne Wächter zurücklassen, während der verwaiste Job stundenlang läuft. Immer: Job abbrechen → prüfen, dass keiner läuft → --fresh neu starten.
  • pkill die Waisen. Abgebrochene/hängende Jobs hinterlassen codex app-server, codex resume und app-server-broker-Prozesse; pkill -9 -f sie während der Bereinigung, damit sie sich nicht über einen langen Durchlauf hinweg ansammeln.
  • Seine Sandbox kann deine Tests nicht ausführen (oft kein beschreibbares Temp-Verzeichnis; es hängt "verifying" für immer) – das ist der GRUND, warum §4s Du-führst-die-Tests-aus-Regel existiert. Dateien lesen (grep/sed/cat) in seiner Sandbox ist in Ordnung.
  • Es kann Dateien schreiben, aber kein git ausführen – committe von der Orchestrator-Sitzung, nachdem es fertig ist.
  • Sitzungs-/Thread-IDs aus seiner Ausgabe sind wiederaufnehmbar (--resume-last / nach ID aufnehmen) – nützlich für Folgegrills, die den Kontext der vorherigen Runde benötigen, vorbehaltlich der obigen Regel "zuerst abbrechen".

Einzeilige Invariante: unabhängiger Reviewer + komprimierter Festplattenzustand + geplante Selbstaufwacher = ein Durchlauf, der zur Korrektheit konvergiert und jeden Hang, Absturz und jede Komprimierung auf dem Weg überlebt.

Herkunft: Destilliert aus einem live hochriskanten Build (Optionshandels-Bot, 2026-07: 6+ Grillrunden, echte NO-AGREEs, ein durch einen Menschen entdecktes Designloch, Verluste auf Tick-Ebene untersucht) und einem verifizierten lokalen Modell-Delegations-Spike. Register + Spezifikationsabschnitt-Ideen der caveman/cavekit-Familie zugeschrieben (github.com/juliusbrussee).

Verwandte Skills