Deliberation

Holen Sie sich in Claude Code eine zweite Meinung von GPT, Gemini und Grok – plus über 400 weitere Modelle über OpenRouter, darunter Qwen, Kimi und DeepSeek. Sieben Domänenexperten (Architect, Code Reviewer, Security Analyst und vier weitere) prüfen Ihre Pläne, finden Fehler und diskutieren Randfälle, bis sie sich einig sind.

Aktueller Blogbeitrag: Meet Deliberation: 400+ models is easy, knowing which ones earn a place is hard.

Wenn drei Modelle streiten, offenbart sich der echte Bug. Runde 1 = unabhängige Top-Befunde. Runde 2 = jedes Modell kritisiert die Auswahl der anderen. Die Uneinigkeitsmatrix zeigt, wo sie auseinandergehen; die Schlussfolgerung zeigt, was tatsächlich zuerst behoben werden sollte.

Was ist Deliberation?

Claude kann GPT, Gemini, Grok oder jedes OpenAI-kompatible Modell (über OpenRouter) um Hilfe bitten – über MCP. Das Plugin übernimmt die Verdrahtung für jeden Anbieter, sodass Sie nur den Prompt schreiben. Jeder Experte hat eine eigene Spezialisierung und kann beraten oder implementieren.

Sie können eine beliebige Teilmenge der Anbieter verwenden. Das Plugin erkennt, welche konfiguriert sind, und leitet entsprechend weiter. OpenRouter ist nur beratend und konfigurationsgesteuert: Modelle werden in ~/.config/deliberation/config.json deklariert (Windows: %APPDATA%\deliberation\config.json; Überschreiben mit DELIBERATION_CONFIG) und ohne Neustart von Claude Code heiß nachgeladen.

Related MCP server: Agents Council

Installation

Claude Code-Plugin (empfohlen):

1. Marktplatz hinzufügen – antonbabenko/agent-plugins

/plugin marketplace add antonbabenko/agent-plugins

2. Plugin installieren

/plugin install deliberation@antonbabenko

3. Setup ausführen

/deliberation:setup

Claude leitet nun komplexe Aufgaben an Ihre GPT-, Gemini-, Grok- und OpenRouter-Experten weiter (Grok und OpenRouter beraten; GPT und Gemini können auch implementieren).

Das Setup ist ein einmaliger Schritt. Die MCP-Server werden durch das Plugin-Manifest registriert, sodass sie automatisch geladen werden und über Updates hinweg aktuell bleiben.

Aktualisieren (Claude Code)

/plugin marketplace update antonbabenko  # pull the new version from the marketplace
/reload-plugins                          # reconnect the MCP servers (or just restart Claude Code)

Aktualisieren auf Nicht-Claude-Hosts: Hosts, die den eigenständigen Server über npx -y @antonbabenko/deliberation-mcp ausführen, erhalten bei jeder frischen Auflösung die neueste veröffentlichte Version. npx speichert aufgelöste Pakete zwischen. Wenn ein Host also einen alten Build ausliefert, leeren Sie den npx-Cache (rm -rf ~/.npm/_npx) oder pinnen/aktualisieren Sie die Version.

Alternative: deliberation-MCP-Server verwenden (eigenständig, funktioniert mit beliebigen Agenten)

Der Orchestrierungsserver ist auch eigenständig veröffentlicht – npm @antonbabenko/deliberation-mcp, offizieller MCP-Registry-Name io.github.antonbabenko/deliberation.

Installation mit einem Klick:

Fügen Sie dies zur MCP-Konfiguration Ihres Hosts hinzu (die meisten Hosts verwenden den Schlüssel mcpServers):

{
  "mcpServers": {
    "deliberation": {
      "command": "npx",
      "args": ["-y", "@antonbabenko/deliberation-mcp"],
      "env": {
        "XAI_API_KEY": "xai-...",
        "OPENROUTER_API_KEY": "sk-or-v1-..."
      }
    }
  }
}

Der env-Block ist die Möglichkeit, Anbieterschlüssel außerhalb von Claude Code zu setzen. GPT und Gemini lesen hier keine Schlüssel – sie verwenden die CLIs codex und agy (separat angemeldet). Lassen Sie diese Zeilen also weg, wenn Sie nur GPT/Gemini verwenden. XAI_API_KEY aktiviert Grok; OPENROUTER_API_KEY aktiviert OpenRouter (das außerdem Modelle in ~/.config/deliberation/config.json deklariert haben muss – der kanonische XDG-Pfad, Windows %APPDATA%\deliberation\config.json – oder Sie verweisen mit DELIBERATION_CONFIG auf einen anderen Ort). Die Ein-Klick-Buttons oben können keine Geheimnisse übertragen – fügen Sie den env-Block nach der Installation von Hand hinzu.

Konfigurationsspeicherort pro Host und der erwartete Schlüssel:

Die Anbieter-Voraussetzungen sind dieselben wie beim Plugin (siehe Anforderungen): die Codex-CLI für GPT, agy für Gemini, XAI_API_KEY für Grok und OPENROUTER_API_KEY plus ~/.config/deliberation/config.json für OpenRouter (Windows: %APPDATA%\deliberation\config.json; Überschreiben des Konfigurationspfads mit DELIBERATION_CONFIG).

Verfügbare Tools: ask-all, consensus (die vollständige Konvergenzschleife in einem Aufruf oder ein einzelner Synthesedurchlauf mit synthesizeAlways:true), consensus-step (steuern Sie die Schleife selbst, eine Aktion pro Aufruf), ask-gpt / ask-gemini / ask-grok / ask-openrouter, panel + ask-one (ermitteln Sie den aktiven Anbietersatz und rufen Sie dann Anbieter einzeln auf – führen Sie sie parallel aus, um sichtbaren Fortschritt pro Anbieter zu erhalten), analyze (schreibgeschützte Analyse über das Debug-Log + Sitzungen: Latenz/Tokens pro Modell + Urteilsübereinstimmung, mit beratenden Tuning-Empfehlungen; configuredOnly und since beschränken den Bericht auf Modelle, die Sie noch ausführen, und einen von Ihnen gewählten Zeitraum), die sieben Experten (architect, plan-reviewer, scope-analyst, code-reviewer, security-analyst, researcher, debugger) sowie die Sitzungstools (session-get / session-revisit / session-annotate). Jedes Ergebnis enthält ms plus das effektive reasoningEffort (HTTP-Anbieter fügen Token-usage hinzu). Ein optionales Debug-Log ("debug": { "enabled": true }) zeichnet Latenz / Tokens / Stimmen auf – niemals Prompts oder Antworten. Diese sind serverseitig und funktionieren daher auf jedem MCP-Host, nicht nur in Claude Code (siehe AGENTS.md).

Das Paket enthält außerdem ein deliberation-setup-Binärprogramm. Führen Sie es einmal mit npx -y --package @antonbabenko/deliberation-mcp deliberation-setup aus, um eine Start-~/.config/deliberation/config.json zu schreiben (eine vorhandene wird nie überschrieben). Die einfache Form npx -y @antonbabenko/deliberation-mcp führt das Standard-Binärprogramm (den Server) aus, das Ihr MCP-Host startet. Für die Verdrahtung von Host-Regeln siehe AGENTS.md und die host-spezifischen Ausschnitte in examples/.

Native Plugins pro Host (Cursor / Codex / Kiro / OpenCode)

Über die rohe MCP-Konfiguration hinaus liefert deliberation native Plugin-Artefakte für vier Hosts, damit die Erfahrung dem Claude-Code-Plugin entspricht (Experten mit Persona + Anleitung, wann zu delegieren ist, nicht nur nackte Tools). Alle diese werden aus den kanonischen Quellen von node scripts/sync-hosts.js generiert und eingecheckt, sodass sie nie abweichen (ein CI-Abweichungstest erzwingt das). Jeder Host durchsucht das Repo nach seinen eigenen Dateien:

Die Anbieter-Anmeldedaten funktionieren genauso wie beim eigenständigen Server (GPT über die Codex CLI, Gemini über agy, XAI_API_KEY für Grok, OPENROUTER_API_KEY für OpenRouter) – setzen Sie nur die Anbieter, die Sie verwenden. Der MCP-Server injiziert bereits jede Experten-Persona serverseitig, sodass diese nativen Dateien die Befehls-/Steuerungsoberfläche des Hosts hinzufügen, nicht duplizierte Logik.

Vollständige Installationsanleitungen pro Host: docs/hosts/ – Cursor, Codex CLI, Kiro, OpenCode.

Voraussetzungen

Sie benötigen mindestens einen Anbieter:

• Codex CLI (GPT): npm install -g @openai/codex, dann codex login.

• Antigravity CLI: Erste Schritte mit der Antigravity CLI und Migration von der Gemini CLI, dann führen Sie agy aus und melden Sie sich an.

• Grok (xAI): Keine CLI zu installieren; die Brücke wird mit dem Plugin geliefert (benötigt Node 18+). Setzen Sie XAI_API_KEY (erhalten Sie einen Schlüssel unter https://console.x.ai).

• OpenRouter: Keine CLI; die Brücke wird mit dem Plugin geliefert (benötigt Node 18+). Setzen Sie OPENROUTER_API_KEY (erhalten Sie einen Schlüssel unter https://openrouter.ai/keys), und deklarieren Sie dann Modelle in ~/.config/deliberation/config.json (Windows: %APPDATA%\deliberation\config.json; überschreiben mit DELIBERATION_CONFIG). Funktioniert mit jedem OpenAI-kompatiblen Endpunkt (Ollama, vLLM, LM Studio, HuggingFace Inference) – die Authentifizierung wird automatisch übersprungen, wenn die Schlüssel-Umgebungsvariable leer ist.

Hinweis für Windows (CLI-Anbieter). npm install -g installiert unter Windows einen codex.cmd-Shim, kein ausführbares Programm, und Node kann eine .cmd-Datei nicht direkt starten – daher schlugen GPT-Aufrufe früher mit nichts weiter als einem Spawn-Fehler fehl. deliberation löst die CLI jetzt selbst auf (PATHEXT, mit Rückgriff auf den eigenen Einstiegspunkt des Pakets) und hält sie aus einer Shell heraus. Falls die Auflösung auf Ihrem Rechner einmal fehlschlägt, setzen Sie CODEX_BIN (GPT) oder AGY_BIN (Gemini) auf die echte ausführbare Datei. Grok und OpenRouter sind nicht betroffen – sie sind HTTP-Brücken und starten nichts.

Befehle

Im Plugin enthalten (verfügbar nach der Installation):

/setup kann auch kurze Aliase (/ask-gpt, /ask-gemini, /ask-grok, /ask-openrouter, /ask-all, /consensus) in ~/.claude/commands/ installieren. Dies ist ein Opt-in. Vorhandene gleichnamige Befehle werden standardmäßig beibehalten; das Setup fragt, bevor es einen von ihnen überschreibt. /deliberation:uninstall entfernt einen Alias nur, wenn er byte-identisch mit der gebündelten Kopie ist.

analyze ist bewusst ausgeschlossen: /analyze ist ein häufiger Name, und eine bloße Kopie kollidiert mit jedem anderen Plugin, das eines mitliefert. Verwenden Sie /deliberation:analyze, das immer verfügbar ist. Wenn ein früheres Setup ~/.claude/commands/analyze.md installiert hat, weist das Setup jetzt auf den Pfad hin, damit Sie es löschen können. /deliberation:uninstall listet auch analyze auf, aber sein Byte-identischer Schutz passt nur auf eine Kopie der aktuellen gebündelten Datei – ein Alias, der von einer älteren Version kopiert wurde, unterscheidet sich und wird bewusst in Ruhe gelassen, anstatt auf gut Glück gelöscht zu werden.

Die Experten

Wann Experten am meisten helfen

• Architekturentscheidungen – „Sollte ich Redis oder In-Memory-Caching verwenden?“

• Festgefahrenes Debugging – nach zwei oder mehr fehlgeschlagenen Versuchen eine neue Perspektive gewinnen

• Vor der Implementierung – einen Plan validieren, bevor Sie Code schreiben

• Sicherheitsbedenken – „Ist dieser Authentifizierungsablauf sicher?“

• Codequalität – eine Zweitmeinung zu Ihrer Implementierung

Wann Experten nicht verwendet werden sollten

• Einfache Dateioperationen (Claude erledigt diese direkt)

• Erster Versuch bei jeder Korrektur (versuchen Sie es zuerst selbst)

• Triviale Fragen (keine Notwendigkeit zu delegieren)

So verwenden Sie es

Beschreiben Sie Ihre Aufgabe. Claude erkennt, wann ein Experte hilft, und delegiert automatisch:

You: "Is this authentication flow secure?"
Claude: routes to the Security Analyst, then synthesizes the findings.

Sie können auch explizit fragen: „Bitte GPT, diese Architektur zu überprüfen“, „Bitte Gemini, ...“ oder „Bitte Grok, ...“. Jeder Experte läuft schreibgeschützt für Analysen oder mit Schreibzugriff, um Korrekturen anzuwenden, und Claude wählt den Modus basierend auf Ihrer Anfrage.

Oder rufen Sie die Slash-Befehle direkt auf – siehe Befehle oben.

Wie /consensus und /ask-* Modelle ehrlich halten

/ask-gpt, /ask-gemini, /ask-grok und /ask-all sind die Schnellbefehle: Jeder sendet ein oder drei externe Modelle, Claude liest die Ausgabe, und Sie erhalten eine synthetisierte Antwort. Einmalig, keine Schleife, keine Peer-Runde.

/consensus ist das schwere Geschütz. Gleiche parallele Verteilung, aber mit einer Peer-Review-Runde und einer mehrrundigen Schleife, die nur stoppt, wenn die Modelle übereinstimmen. Der Preis: Der Orchestrator (Claude) schreibt den Review-Prompt, gibt eine Stimme ab, entscheidet, welche Einwände real sind, und führt die Schleife aus. Allein gelassen kann dieses Setup stillschweigend seinen eigenen Plan absegnen. Vier Schutzmechanismen verhindern das.

Siehe das detaillierte Diagramm mit Bias-Schutz und Modellfluss

Die vier Schutzmechanismen:

• Blindes Urteil. Claude veröffentlicht sein eigenes Urteil (APPROVE / REQUEST CHANGES / REJECT) in einer Nachricht, die vor derjenigen gesendet wird, die das Gremium aufruft. Die Vorabverpflichtung steht im Transkript, sodass Claude seine Meinung nicht ändern kann, nachdem es die anderen gesehen hat. Die Engine erzwingt dies: Das Gremium wird erst offengelegt, wenn das blinde Urteil aufgezeichnet ist.

• Peer-Review. Jedes externe Modell überprüft den Plan unabhängig und gibt ein Urteil plus kategorisierte kritische Punkte zurück; Claude wägt sie als Schiedsrichter ab. Die Modelle stimmen ab, Claude entscheidet.

• Keine Selbstgenehmigung. Eine Runde konvergiert nur, wenn jedes antwortende externe Modell zustimmt und mindestens ein externes tatsächlich geantwortet hat. Claudes eigene Zustimmung trägt eine Runde nie allein. Ein Anbieter, der einen Fehler meldet (z. B. ein nicht konfiguriertes Grok, das missing-auth zurückgibt), fällt aus der Zählung heraus, anstatt die Schleife zu blockieren.

• Kein stilles Verwerfen. Jeder kritische Punkt, der verworfen oder aufgeschoben wird, wird im Abschlussbericht mit einer einzeiligen Begründung geliefert, einschließlich der Fälle, in denen Claude einen seiner eigenen blinden Einwände zurücknimmt. Die Engine lehnt eine Entscheidung ab, die einen Punkt ohne Begründung verwirft.

Die /ask-*-Befehle tragen eine leichtere Version derselben Regel. Das externe Modell berät nur: Claude liest die Ausgabe, wendet sein eigenes Urteil an und ist für die synthetisierte Antwort verantwortlich. Wenn die Modelle übereinstimmen, ist das ein Input, kein Urteil.

/consensus ist ein dünner Treiber über die Kern-Konvergenz-Engine (core/consensus-loop.js); die Schleifenmechanik – Rundenzählung, die Konvergenzregel, die konfigurierbare Max-Runden-Obergrenze, der Verlauf und das Konfidenzlabel – lebt in der Engine, nicht im Befehl. Jede Runde:

1. Blindes Urteil. Claude gibt sein eigenes Urteil (transkript-sichtbar) ab, BEVOR das Panel enthüllt wird; die Engine gibt die Enthüllung erst nach dem Urteil frei.

2. Panel-Review. GPT, Gemini, Grok (sowie alle konfigurierten OpenRouter-Delegierten) prüfen den Plan parallel und geben APPROVE / REQUEST CHANGES / REJECT sowie kategorisierte kritische Punkte ab. Der Server parst jedes Urteil.

3. Schiedsrichter-Entscheidung + Überarbeitung. Claude gleicht die Panel-Urteile mit seinem eigenen blinden Urteil ab; für jeden kritischen Punkt wählt es akzeptieren, verwerfen (Begründung erforderlich) oder aufschieben und überarbeitet den Plan für die nächste Runde.

Die Schleife konvergiert, wenn mindestens ein antwortender externer Teilnehmer APPROVE gibt, niemand REJECT, keine kritischen Punkte akzeptiert bleiben und Claude APPROVE entscheidet – Claude kann sich also nicht selbst genehmigen. Andernfalls stoppt sie bei consensus.maxRounds (Standard 5, konfigurierbar) als unresolved. Das Konfidenzlabel spiegelt wider, wie schnell sie sich stabilisiert hat (Runde 1 = hoch, 2–3 = mittel, 4–5 = niedrig).

Dieselbe Engine unterstützt die Einstiegspunkte, die andere Hosts nutzen: das consensus-Tool (führt die gesamte Schleife serverseitig in einem Aufruf mit einem Provider-Schiedsrichter aus, oder einen einzelnen Synthese-Durchlauf mit synthesizeAlways:true) und consensus-step (steuern Sie es selbst, eine Aktion pro Aufruf). Siehe TECHNICAL.md für die Taxonomie und den Engine-Vertrag.

Eine frühere Revision führte eine zusätzliche „Stage 2"-anonymisierte Peer-Kreuzprüfung durch (jedes Modell bewertete die Antworten der anderen blind, adaptiert von karpathy/llm-council). Die engine-getriebene Neufassung entfernte sie, um eine einzige Quelle der Wahrheit zu behalten; sie könnte als Engine-Funktion zurückkehren.

Konfiguration

Die vollständige Setup- und Konfigurationsreferenz finden Sie in SETUP.md. Sie umfasst:

• Expertenmodi – beratend (read-only) vs. implementierend (workspace-write), automatisch aus Ihrer Anfrage gewählt

• Konfigurationsdatei – Speicherort (~/.config/deliberation/config.json), die DELIBERATION_CONFIG-Überschreibung und Hot-Reload

• Die sechs Konfigurationsabschnitte – providers, models, routing, consensus, sessions, debug – mit einem Minimalbeispiel

• OpenRouter-Modelle – Deklaration von Einträgen, askAll / consensus-Berechtigung, Fan-out, reasoningEffort und Schiedsrichterauswahl; consensus konfiguriert außerdem das Rundenziel (maxRounds) und das Wandzeit-Budget (maxWallMs, Standard 20 Min.)

• Timeouts – providers.defaults.timeout erhöht die Obergrenze pro Aufruf für alle Provider gleichzeitig; providers.<name>.timeout überschreibt einen einzelnen, und ein festgelegtes Modell mit models.<id>.timeout hat weiterhin Vorrang. Ein ratenbegrenzter (HTTP 429) Aufruf wird einmal wiederholt, wobei das Retry-After des Upstreams berücksichtigt wird

• Debug-Log – optionale Latenz-/Token-/Abstimmungs-Trace

• Sitzungspersistenz – optionale On-Disk-Ausführungsverlauf (inkl. der hostgesteuerten /consensus-Schleife) und die session-*-Tools; sessions.captureText (Standard: aus) speichert zusätzlich Provider-Antworttexte (bereinigt)

Für Provider-Interna, Umgebungsvariablen und manuelles MCP-Setup siehe TECHNICAL.md.

Autor

Gepflegt von Anton Babenko – LinkedIn, X/Twitter.

Mitwirken

Beiträge sind willkommen. Siehe CONTRIBUTING.md für den Workflow, Commit-Konventionen und den automatisierten Release-Prozess.

Lizenz

MIT