Deliberation

Получите второе мнение в Claude Code от GPT, Gemini, Grok — а также более 400 моделей через OpenRouter, включая Qwen, Kimi и DeepSeek. Семь экспертов в предметных областях (Архитектор, Ревьюер кода, Аналитик безопасности и ещё четыре) проверяют ваши планы, находят ошибки и обсуждают спорные случаи, пока не придут к согласию.

Недавний пост в блоге: Знакомьтесь, Deliberation: 400+ моделей — это просто, а вот понять, какие из них заслуживают места, — сложно.

Когда три модели спорят, настоящая ошибка проявляется. Раунд 1 = независимые главные находки. Раунд 2 = каждая модель критикует выбор других. Матрица разногласий показывает, где они расходятся; вывод показывает, что на самом деле исправить в первую очередь.

Что такое Deliberation?

Claude может попросить GPT, Gemini, Grok или любую OpenAI-совместимую модель (через OpenRouter) о помощи через MCP. Плагин берёт на себя настройку для каждого провайдера, так что вам остаётся только написать промпт. Каждый эксперт имеет свою специализацию и может консультировать или реализовывать.

Вы можете использовать любое подмножество провайдеров. Плагин определяет, какие настроены, и маршрутизирует соответственно. 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) или зафиксируйте/обновите версию.

Альтернатива: используйте MCP-сервер deliberation (автономный, работает с любыми агентами)

Оркестрационный сервер также опубликован отдельно — 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 не читают ключи здесь — они используют CLI codex и agy (входят отдельно), поэтому удалите эти строки, если используете только GPT/Gemini. XAI_API_KEY включает Grok; OPENROUTER_API_KEY включает OpenRouter (которому также нужны модели, объявленные в ~/.config/deliberation/config.json — канонический путь XDG, Windows %APPDATA%\deliberation\config.json — или укажите другой путь через DELIBERATION_CONFIG). Кнопки установки в один клик выше не могут содержать секреты — добавьте блок env вручную после установки.

Расположение конфигурации для каждого хоста и ожидаемый ключ:

Предварительные требования для провайдеров такие же, как для плагина (см. Требования): Codex CLI для GPT, gemini для Gemini, XAI_API_KEY для Grok и OPENROUTER_API_KEY плюс ~/.config/deliberation/config.json для OpenRouter (Windows: %APPDATA%\deliberation\config.json; переопределите путь конфигурации через DELIBERATION_CONFIG).

Доступные инструменты: ask-all, consensus (полный цикл сходимости за один вызов или один проход синтеза с synthesizeAlways:true), consensus-step (управляйте циклом сами, одно действие за вызов), ask-gpt / ask-gemini / ask-grok / ask-openrouter, panel + ask-one (обнаружение активного набора провайдеров, затем вызов провайдеров по отдельности — запускайте их параллельно для видимого прогресса по каждому), analyze (аналитика только для чтения по журналу отладки и сессиям: задержка/токены на модель + согласованность вердиктов, с рекомендациями по настройке; configuredOnly и since ограничивают отчёт только теми моделями, которые вы ещё используете, и выбранным периодом), семь экспертов (architect, plan-reviewer, scope-analyst, code-reviewer, security-analyst, researcher, debugger) и инструменты сессий (session-get / session-revisit / session-annotate). Каждый результат содержит ms и эффективный reasoningEffort (HTTP-провайдеры добавляют usage токенов). Необязательный журнал отладки ("debug": { "enabled": true }) записывает задержку / токены / голоса — но никогда промпты или ответы. Эти инструменты серверные, поэтому работают на любом MCP-хосте, не только в Claude Code (см. 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 / Windsurf / Kiro / OpenCode)

Помимо конфигурации MCP, описанной выше, deliberation поставляет нативные артефакты плагинов для четырёх хостов, чтобы опыт соответствовал плагину Claude Code (эксперты с персонами + руководство по делегированию, а не просто голые инструменты). Все они генерируются из канонических источников с помощью node scripts/sync-hosts.js и фиксируются, поэтому никогда не расходятся (CI-тест на расхождение это обеспечивает). Каждый хост сканирует репозиторий на свои файлы:

Учётные данные провайдеров работают так же, как и у автономного сервера (GPT через Codex CLI, Gemini через agy, XAI_API_KEY для Grok, OPENROUTER_API_KEY для OpenRouter) — задавайте только те провайдеры, которые используете. MCP-сервер уже внедряет каждую экспертную персону на стороне сервера, поэтому эти нативные файлы добавляют командный/управляющий слой хоста, а не дублируют логику.

Полные руководства по установке для каждого хоста: docs/hosts/ — Cursor, Codex CLI, Kiro, OpenCode.

Требования

Вам нужен хотя бы один провайдер:

• Codex CLI (GPT): npm install -g @openai/codex, затем codex login.

• Antigravity CLI: Getting Started with Antigravity CLI и Migrating from 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). npm install -g в Windows устанавливает shim 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, он доступен всегда. Если более ранняя установка создала ~/.claude/commands/analyze.md, setup теперь покажет путь к нему, чтобы вы могли его удалить. /deliberation:uninstall также перечисляет analyze, но его защита по побайтному совпадению срабатывает только для копии текущего встроенного файла — алиас, скопированный из более старой версии, будет отличаться, и его намеренно не трогают, а не удаляют наугад.

Эксперты

Когда эксперты наиболее полезны

• Архитектурные решения - "Should I use Redis or in-memory caching?"

• Застрявшая отладка - после двух и более неудачных попыток получите свежий взгляд

• Перед реализацией - проверьте план до написания кода

• Вопросы безопасности - "Is this auth flow safe?"

• Качество кода - второе мнение о вашей реализации

Когда эксперты не нужны

• Простые файловые операции (Claude обрабатывает их напрямую)

• Первая попытка любого исправления (сначала попробуйте сами)

• Тривиальные вопросы (делегировать не нужно)

Как использовать

Опишите задачу. Claude определяет, когда эксперт поможет, и делегирует автоматически:

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

Вы также можете попросить явно: "Ask GPT to review this architecture", "Ask Gemini to..." или "Ask Grok to...". Каждый эксперт работает в режиме «только чтение» для анализа или с правом записи для применения исправлений, и Claude выбирает режим в зависимости от вашего запроса.

Или вызывайте слэш-команды напрямую — см. раздел «Команды» выше.

Как /consensus и /ask-* не дают моделям лукавить

/ask-gpt, /ask-gemini, /ask-grok и /ask-all — это быстрые команды: каждая отправляет одну или три внешние модели, Claude читает вывод, и вы получаете один синтезированный ответ. Одиночный запуск, без цикла, без раунда рецензирования.

/consensus — тяжёлая команда. Та же параллельная отправка, но с раундом взаимного рецензирования и многораундовым циклом, который останавливается только тогда, когда модели приходят к согласию. Цена: оркестратор (Claude) пишет промпт для рецензии, голосует, решает, какие возражения обоснованы, и запускает цикл. Если оставить всё как есть, такая схема может тихо штамповать собственный план. Этому препятствуют четыре защиты.

См. подробную диаграмму с защитами от смещений и потоком по каждой модели

Четыре защиты:

• Слепой вердикт. Claude публикует собственный вердикт (APPROVE / REQUEST CHANGES / REJECT) в сообщении, отправленном до того, которое вызывает панель. Предварительное обязательство остаётся в транскрипте, поэтому Claude не может изменить своё мнение после того, как увидит остальных. Движок обеспечивает это: панель не раскрывается, пока не зафиксирован слепой вердикт.

• Взаимное рецензирование. Каждая внешняя модель независимо рецензирует план и возвращает вердикт плюс категоризированные критические замечания; Claude взвешивает их как арбитр. Модели голосуют, Claude выносит решение.

• Никакого самостоятельного одобрения. Раунд сходится только тогда, когда каждая ответившая внешняя модель одобряет и хотя бы одна внешняя модель действительно ответила. Собственное одобрение 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 согласует вердикты панели и собственный слепой вердикт; по каждой критической проблеме он выбирает принять, отклонить (требуется обоснование) или отложить, затем дорабатывает план для следующего раунда.

Цикл сходится, когда как минимум один ответивший внешний участник одобряет, никто не отклоняет, не остаётся принятых критических проблем, и Claude выносит вердикт APPROVE — то есть Claude не может одобрить сам себя. В противном случае цикл останавливается на consensus.maxRounds (по умолчанию 5, настраивается) со статусом unresolved. Метка уверенности отражает, насколько быстро было достигнуто соглашение (раунд 1 = высокая, 2–3 = средняя, 4–5 = низкая).

Тот же движок поддерживает точки входа, которые используют другие хосты: инструмент consensus (запускает весь цикл на стороне сервера одним вызовом с арбитром-провайдером или выполняет одиночный синтез-проход при synthesizeAlways:true) и consensus-step (управляйте сами, одно действие за вызов). См. TECHNICAL.md для таксономии и контракта движка.

В более ранней ревизии был дополнительный «Этап 2» — анонимное перекрёстное рецензирование коллегами (каждая модель вслепую оценивала ответы других, адаптировано из karpathy/llm-council). Переработка на основе движка убрала его, чтобы сохранить единый источник истины; он может вернуться как функция движка.

Конфигурация

Полное руководство по установке и настройке находится в SETUP.md. Оно охватывает:

• Экспертные режимы — консультативный (read-only) против исполнительного (workspace-write), выбираются автоматически на основе вашего запроса

• Файл конфигурации — расположение (~/.config/deliberation/config.json), переопределение DELIBERATION_CONFIG и горячая перезагрузка

• Шесть разделов конфигурации — providers, models, routing, consensus, sessions, debug — с минимальным примером

• Модели OpenRouter — объявление записей, право на askAll / consensus, фан-аут, reasoningEffort и выбор арбитра; consensus также настраивает лимит раундов (maxRounds) и бюджет реального времени (maxWallMs, по умолчанию 20 минут)

• Таймауты — providers.defaults.timeout повышает потолок на один вызов сразу для всех провайдеров; providers.<name>.timeout переопределяет один, а таймаут закреплённой модели models.<id>.timeout по-прежнему имеет приоритет. Вызов с ограничением частоты (HTTP 429) повторяется один раз с учётом Retry-After вышестоящего сервиса

• Журнал отладки — опциональный трейс задержек / токенов / голосования

• Персистентность сессий — опциональное сохранение истории запусков на диск (включая управляемый хостом цикл /consensus) и инструменты session-*; sessions.captureText (по умолчанию выключен) дополнительно сохраняет тела ответов провайдеров (очищенные)

О внутреннем устройстве провайдеров, переменных окружения и ручной настройке MCP см. TECHNICAL.md.

Автор

Поддерживается Антоном Бабенко — LinkedIn, X/Twitter.

Участие

Вклад приветствуется. См. CONTRIBUTING.md о рабочем процессе, соглашениях о коммитах и автоматизированном процессе релизов.

Лицензия

MIT