Deliberation

Claude Code で GPT、Gemini、Grok からセカンドオピニオンを得られます。さらに OpenRouter 経由で Qwen、Kimi、DeepSeek を含む 400 以上のモデルも利用可能です。7 人のドメインエキスパート（Architect、Code Reviewer、Security Analyst、その他 4 人）があなたの計画をレビューし、バグを見つけ、合意に達するまでエッジケースについて議論します。

最近のブログ記事: Deliberation を紹介: 400以上のモデルは簡単、どのモデルが居場所を得るかを見極めるのは難しい。

3つのモデルが議論すると、本当のバグが明らかになります。ラウンド1 = 独立したトップの発見。ラウンド2 = 各モデルが他のモデルの選択を批判。不一致マトリックスはどこで分岐するかを示し、結論は実際に最初に修正すべきことを示します。

Deliberation とは?

Claude は MCP を通じて GPT、Gemini、Grok、または任意の OpenAI 互換モデル（OpenRouter 経由）に助けを求めることができます。プラグインが各プロバイダーの配線を処理するので、プロンプトを書くだけで済みます。各エキスパートは明確な専門分野を持ち、アドバイスまたは実装を行うことができます。

プロバイダーの任意のサブセットを使用できます。プラグインは設定されているものを検出し、それに応じてルーティングします。OpenRouter はアドバイスのみで、設定駆動です: モデルは ~/.config/deliberation/config.json（Windows: %APPDATA%\deliberation\config.json; DELIBERATION_CONFIG で上書き）で宣言され、Claude Code を再起動せずにホットリロードされます。

Related MCP server: Agents Council

インストール

Claude Code プラグイン（推奨）:

1. マーケットプレイスを追加 - antonbabenko/agent-plugins

/plugin marketplace add antonbabenko/agent-plugins

2. プラグインをインストール

/plugin install deliberation@antonbabenko

3. セットアップを実行

/deliberation:setup

Claude は複雑なタスクを GPT、Gemini、Grok、OpenRouter のエキスパートにルーティングします（Grok と OpenRouter はアドバイス、GPT と Gemini は実装も可能）。

セットアップは一度きりのステップです。 MCP サーバーはプラグインマニフェストによって登録されるため、自動的に読み込まれ、更新後も最新の状態が維持されます。

更新（Claude Code）

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

非 Claude ホストでの更新: npx -y @antonbabenko/deliberation-mcp でスタンドアロンサーバーを実行するホストは、新規解決のたびに最新の公開バージョンを取得します。npx は解決済みパッケージをキャッシュするため、ホストが古いビルドを提供する場合は、npx キャッシュをクリア（rm -rf ~/.npm/_npx）するか、バージョンを固定/更新してください。

代替: deliberation MCP サーバーを使用（スタンドアロン、任意のエージェントで動作）

オーケストレーションサーバーは単独でも公開されています - npm @antonbabenko/deliberation-mcp、公式 MCP レジストリ名 io.github.antonbabenko/deliberation。

ワンクリックインストール:

これをホストの MCP 設定に追加します（ほとんどのホストは mcpServers キーを使用）:

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

env ブロックは、Claude Code の外部でプロバイダーキーを設定する方法です。GPT と Gemini はここでキーを読み取りません - それらは codex と agy CLI（個別にログイン）を使用するため、GPT/Gemini のみを使用する場合はそれらの行を削除してください。XAI_API_KEY は Grok を有効にし、OPENROUTER_API_KEY は OpenRouter を有効にします（OpenRouter は ~/.config/deliberation/config.json - 標準の XDG パス、Windows では %APPDATA%\deliberation\config.json - にモデルを宣言する必要もあります。または DELIBERATION_CONFIG で別の場所を指定）。上記のワンクリックボタンはシークレットを運べないため、インストール後に env ブロックを手動で追加してください。

ホストごとの設定場所と期待されるキー:

プロバイダーの前提条件はプラグインと同じです（要件 を参照）: GPT には Codex CLI、Gemini には agy、Grok には XAI_API_KEY、OpenRouter には OPENROUTER_API_KEY と ~/.config/deliberation/config.json（Windows: %APPDATA%\deliberation\config.json; DELIBERATION_CONFIG で設定パスを上書き）が必要です。

公開されるツール: ask-all、consensus（1回の呼び出しで完全な収束ループ、または synthesizeAlways:true による単一の合成パス）、consensus-step（ループを自分で駆動、呼び出しごとに1つのアクション）、ask-gpt / ask-gemini / ask-grok / ask-openrouter、panel + ask-one（アクティブなプロバイダーセットを発見し、プロバイダーを個別に呼び出します - プロバイダーごとの進行状況を表示するために並列で発行）、analyze（読み取り専用でデバッグログとセッションの分析を実行: モデルごとのレイテンシ / トークン + 判定の一致、アドバイザリのチューニング提案付き; configuredOnly と since で、現在実行中のモデルと選択した期間にレポートを限定）、7人のエキスパート（architect、plan-reviewer、scope-analyst、code-reviewer、security-analyst、researcher、debugger）、およびセッションツール（session-get / session-revisit / session-annotate）。すべての結果には ms と有効な reasoningEffort が含まれます（HTTP プロバイダーはトークン usage を追加）。オプションのデバッグログ（"debug": { "enabled": true }）はレイテンシ / トークン / 投票を記録します - プロンプトや応答は決して記録しません。これらはサーバーサイドであるため、Claude Code だけでなく、すべての MCP ホストで動作します（AGENTS.md を参照）。

パッケージには deliberation-setup バイナリも同梱されています。npx -y --package @antonbabenko/deliberation-mcp deliberation-setup で一度実行すると、スターターの ~/.config/deliberation/config.json が作成されます（既存のファイルを上書きすることはありません）。通常の npx -y @antonbabenko/deliberation-mcp 形式はデフォルトのバイナリ（サーバー）を実行します。これは MCP ホストが起動するものです。ホストルールの配線については、AGENTS.md と examples/ のホスト別スニペットを参照してください。

ホスト別ネイティブプラグイン（Cursor / Codex / Kiro / OpenCode）

上記の生の MCP 設定に加えて、deliberation は4つのホスト向けにネイティブプラグインアーティファクトを提供し、Claude Code プラグインと同じ体験を実現します（ペルソナを持つエキスパート + いつ委任すべきかのガイダンス。単なるツールではありません）。これらはすべて node scripts/sync-hosts.js によって正規ソースから生成され、コミットされているため、ドリフトすることはありません（CI のドリフトテストがそれを強制します）。各ホストはリポジトリ内の自ファイルをスキャンします:

プロバイダー認証情報はスタンドアロンサーバーと同じです（GPTはCodex CLI経由、Geminiは agy 経由、Grokは XAI_API_KEY、OpenRouterは OPENROUTER_API_KEY）— 使用するプロバイダーのみ設定してください。MCPサーバーは各エキスパートのペルソナをサーバーサイドで注入するため、これらのネイティブファイルはホストのコマンド／ステアリング面を追加するものであり、ロジックの重複ではありません。

ホスト別の完全なインストールガイド: docs/hosts/ — Cursor、Codex CLI、Kiro、OpenCode。

要件

少なくとも1つのプロバイダーが必要です：

• Codex CLI（GPT）：npm install -g @openai/codex を実行し、その後 codex login を実行します。

• Antigravity CLI：Antigravity CLI入門 と Gemini CLIからの移行 を参照し、agy を実行してログインします。

• Grok（xAI）：インストールするCLIはありません。ブリッジはプラグインに同梱されています（Node 18+が必要）。XAI_API_KEY を設定します（キーは https://console.x.ai で取得）。

• OpenRouter：CLIはありません。ブリッジはプラグインに同梱されています（Node 18+が必要）。OPENROUTER_API_KEY を設定し（キーは https://openrouter.ai/keys で取得）、その後 ~/.config/deliberation/config.json でモデルを宣言します（Windows：%APPDATA%\deliberation\config.json；DELIBERATION_CONFIG で上書き可能）。OpenAI互換の任意のエンドポイント（Ollama、vLLM、LM Studio、HuggingFace Inference）で動作します — キー環境変数が空の場合は認証が自動的にスキップされます。

Windowsに関する注意（CLIプロバイダー）。 Windowsで npm install -g を実行すると、実行可能ファイルではなく codex.cmd シムがインストールされ、Nodeは .cmd を直接起動できません — そのため、GPT呼び出しはスパウンエラーのみで失敗していました。deliberationはCLI自体を解決し（PATHEXT、フォールバックとしてパッケージ自身のエントリポイント）、シェルを介さずに実行します。お使いのマシンで解決に失敗する場合は、CODEX_BIN（GPT）または AGY_BIN（Gemini）を実際の実行可能ファイルに指定してください。GrokとOpenRouterは影響を受けません — これらはHTTPブリッジであり、何もスパウンしません。

コマンド

プラグインに同梱（インストール後に利用可能）：

/setup は短いエイリアス（/ask-gpt、/ask-gemini、/ask-grok、/ask-openrouter、/ask-all、/consensus）を ~/.claude/commands/ にインストールすることもできます。これはオプトインです。同名の既存コマンドはデフォルトで保持され、setupは上書き前に確認を求めます。/deliberation:uninstall は、エイリアスが同梱コピーとバイト単位で同一の場合にのみ削除します。

analyze は意図的に除外されています：/analyze は一般的な名前であり、そのままコピーすると同様のコマンドを同梱する他のプラグインと衝突します。常に利用可能な /deliberation:analyze を使用してください。以前のsetupで ~/.claude/commands/analyze.md がインストールされた場合、setupはそのパスを指摘するので削除できます。/deliberation:uninstall も analyze を一覧表示しますが、そのバイト同一ガードは 現在の 同梱ファイルのコピーにのみ一致します — 古いリリースからコピーされたエイリアスは異なるため、推測で削除するのではなく意図的にそのまま残されます。

エキスパート

エキスパートが役立つ場面

• アーキテクチャの決定 — 「Redisとインメモリキャッシュのどちらを使うべき？」

• デバッグで行き詰まったとき — 2回以上失敗した後、新しい視点を得る

• 実装前 — コードを書く前に計画を検証

• セキュリティ上の懸念 — 「この認証フローは安全？」

• コード品質 — 実装に対するセカンドオピニオン

エキスパートを使うべきでない場面

• 単純なファイル操作（Claudeが直接処理）

• 修正の最初の試み（まず自分で試す）

• 些細な質問（委任する必要はない）

使用方法

タスクを説明してください。Claudeはエキスパートが役立つタイミングを検出し、自動的に委任します：

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

明示的に依頼することもできます：「GPTにこのアーキテクチャをレビューしてもらって」、「Geminiに…」、「Grokに…」。各エキスパートは分析用の読み取り専用、または修正を適用するための書き込みアクセス付きで実行され、Claudeはリクエストからモードを選択します。

またはスラッシュコマンドを直接呼び出してください — 上記のコマンドを参照してください。

/consensus と /ask-* がモデルの誠実さを保つ仕組み

/ask-gpt、/ask-gemini、/ask-grok、/ask-all はクイックコマンドです：それぞれ1つまたは3つの外部モデルをディスパッチし、Claudeが出力を読み、1つの統合された回答を得ます。シングルショット、ループなし、ピアラウンドなし。

/consensus は本格的なものです。同じ並列ディスパッチですが、ピアレビューラウンドと、モデルが合意するまで停止しないマルチラウンドループが追加されています。コスト：オーケストレーター（Claude）がレビュープロンプトを作成し、投票し、どの異議が本物かを判断し、ループを実行します。そのまま放置すると、この設定は静かに自身の計画を承認印としてしまう可能性があります。4つのガードがそれを防ぎます。

バイアスガードとモデル別フローを含む詳細図

4つのガード：

• ブラインド判定。 Claudeはパネルを呼び出すメッセージの 前 に送信されるメッセージで自身の判定（APPROVE / REQUEST CHANGES / REJECT）を投稿します。事前コミットメントはトランスクリプトに残るため、Claudeは他の意見を見た後に自身の意見を変更できません。エンジンがこれを強制します：パネルはブラインド判定が記録されるまで公開されません。

• ピアレビュー。 各外部モデルが計画を独立してレビューし、判定とカテゴリ別の重大な問題を返します。Claudeはアービターとしてそれらを評価します。モデルが投票し、Claudeが裁定します。

• 自己承認なし。 ラウンドが収束するのは、応答したすべての外部モデルが承認し、かつ少なくとも1つの外部モデルが実際に回答した場合のみです。Claude自身の承認だけでラウンドが成立することはありません。エラーを返したプロバイダー（未設定のGrokが missing-auth を返す場合など）は、ループを詰まらせる代わりにカウントから外れます。

• 黙殺なし。 却下または延期されたすべての重大な問題には、最終レポートに一言の理由が添付されます。Claudeが自身のブラインド異議の一部を撤回する場合も含みます。エンジンは、理由なしに問題を却下する裁定を拒否します。

/ask-* コマンドは同じルールの軽量版を適用します。外部モデルは助言のみ行います：Claudeが出力を読み、自身の判断を適用し、統合された回答に対して責任を持ちます。モデルが一致した場合、それは入力であり、判定ではありません。

/consensus はコア収束エンジン（core/consensus-loop.js）の薄いドライバーです。ループの仕組み — ラウンドカウント、収束ルール、設定可能な最大ラウンド数上限、履歴、信頼度ラベル — はコマンドではなくエンジンにあります。各ラウンド：

1. ブラインド判定。 Claudeはパネルが公開される前に自身の判定（トランスクリプト表示）を下します。エンジンはその判定を条件にパネルの公開をゲートします。

2. パネルレビュー。 GPT、Gemini、Grok（および設定済みのOpenRouterデリゲート）がプランを並行してレビューし、APPROVE / REQUEST CHANGES / REJECT とカテゴリ別の重大な問題を出力します。サーバーは各判定を解析します。

3. 調停者による裁定と改訂。 Claudeはパネルの判定と自身のブラインド判定を調整します。各重大な問題について、受け入れる（accept）、却下する（dismiss、理由必須）、先送りする（defer）のいずれかを選択し、次のラウンドに向けてプランを改訂します。

ループは、応答した外部審査員の少なくとも1人が承認し、誰も拒否せず、受け入れられた重大な問題がゼロで、かつClaudeがAPPROVEと裁定した場合に収束します（つまりClaude自身だけでは承認できません）。それ以外の場合は、consensus.maxRounds（デフォルト5、設定可能）でunresolvedとして停止します。信頼度ラベルは収束までの速さを反映します（ラウンド1 = 高、2〜3 = 中、4〜5 = 低）。

同じエンジンが、他のホストが使用するエントリポイントも支えています。consensusツール（プロバイダー調停者付きでループ全体をサーバーサイドで1回の呼び出しで実行、またはsynthesizeAlways:trueで単一の統合パスを実行）とconsensus-step（自分でドライブする、1アクションにつき1呼び出し）です。分類法とエンジン契約についてはTECHNICAL.mdを参照してください。

以前のリビジョンでは、「ステージ2」の匿名ピア相互レビュー（各モデルが他のモデルの回答をブラインドで採点、karpathy/llm-councilから適用）を追加で実行していました。エンジン駆動の書き直しにより、単一の真実源を維持するためにこれは削除されました。将来エンジンの機能として復活する可能性があります。

設定

完全なセットアップと設定のリファレンスは**SETUP.md**にあります。以下をカバーしています：

• エキスパートモード - アドバイザリー（read-only）と実装（workspace-write）。リクエストに応じて自動選択されます。

• 設定ファイル - 場所（~/.config/deliberation/config.json）、DELIBERATION_CONFIGによる上書き、ホットリロード。

• 6つの設定セクション - providers、models、routing、consensus、sessions、debug - 最小限の例付き。

• OpenRouterモデル - レコードの宣言、askAll / consensusの対象、ファンアウト、reasoningEffort、調停者の選択。consensusはラウンド上限（maxRounds）とウォールタイム予算（maxWallMs、デフォルト20分）も設定します。

• タイムアウト - providers.defaults.timeoutはすべてのプロバイダーの呼び出し上限を一括で引き上げます。providers.<name>.timeoutは1つのプロバイダーを上書きし、固定モデルのmodels.<id>.timeoutが最優先されます。レート制限（HTTP 429）を受けた呼び出しは、上流のRetry-Afterを尊重して1回再試行されます。

• デバッグログ - オプトインのレイテンシ / トークン / 投票トレース。

• セッション永続化 - オプトインのディスク上の実行履歴（ホスト駆動の/consensusループを含む）とsession-*ツール。sessions.captureText（デフォルトオフ）は、プロバイダーのレスポンス本文も追加で保存します（スクラブ済み）。

プロバイダー内部、環境変数、手動のMCPセットアップについては**TECHNICAL.md**を参照してください。

著者

Anton Babenkoがメンテナンス - LinkedIn、X/Twitter。

貢献

貢献歓迎です。ワークフロー、コミット規約、自動化されたリリースプロセスについてはCONTRIBUTING.mdを参照してください。

ライセンス

MIT