Deliberation

Obtén una segunda opinión en Claude Code de GPT, Gemini y Grok, además de más de 400 modelos a través de OpenRouter, incluidos Qwen, Kimi y DeepSeek. Siete expertos de dominio (Arquitecto, Revisor de Código, Analista de Seguridad y otros cuatro) revisan tus planes, encuentran errores y debaten casos límite hasta que se ponen de acuerdo.

Entrada de blog reciente: Conoce Deliberation: 400+ modelos es fácil, saber cuáles se ganan un lugar es difícil.

Cuando tres modelos discuten, el error real se revela. Ronda 1 = hallazgos principales independientes. Ronda 2 = cada modelo arremete contra las selecciones de los demás. La matriz de desacuerdos muestra dónde divergen; la conclusión muestra qué arreglar primero en realidad.

¿Qué es Deliberation?

Claude puede pedir ayuda a GPT, Gemini, Grok o cualquier modelo compatible con OpenAI (a través de OpenRouter) mediante MCP. El plugin gestiona la configuración de cada proveedor para que solo tengas que escribir el prompt. Cada experto tiene una especialidad distinta y puede asesorar o implementar.

Puedes usar cualquier subconjunto de los proveedores. El plugin detecta cuáles están configurados y enruta en consecuencia. OpenRouter es solo de asesoramiento y se basa en configuración: los modelos se declaran en ~/.config/deliberation/config.json (Windows: %APPDATA%\deliberation\config.json; se puede sobrescribir con DELIBERATION_CONFIG) y se recargan en caliente sin reiniciar Claude Code.

Related MCP server: Agents Council

Instalación

Plugin de Claude Code (recomendado):

1. Añade el marketplace - antonbabenko/agent-plugins

/plugin marketplace add antonbabenko/agent-plugins

2. Instala el plugin

/plugin install deliberation@antonbabenko

3. Ejecuta la configuración

/deliberation:setup

Ahora Claude enruta tareas complejas a tus expertos de GPT, Gemini, Grok y OpenRouter (Grok y OpenRouter asesoran; GPT y Gemini también pueden implementar).

La configuración es un paso único. Los servidores MCP quedan registrados por el manifiesto del plugin, por lo que se cargan automáticamente y se mantienen actualizados en cada actualización.

Actualización (Claude Code)

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

Actualización en hosts que no son Claude Code: los hosts que ejecutan el servidor independiente mediante npx -y @antonbabenko/deliberation-mcp obtienen la última versión publicada en cada resolución nueva. npx almacena en caché los paquetes resueltos, así que si un host sirve una compilación antigua, limpia la caché de npx (rm -rf ~/.npm/_npx) o fija/actualiza la versión.

Alternativa: usar el servidor MCP deliberation (independiente, funciona con cualquier agente)

El servidor de orquestación también se publica por separado: npm @antonbabenko/deliberation-mcp, nombre en el Registro Oficial de MCP io.github.antonbabenko/deliberation.

Instalación con un clic:

Añade esto a la configuración MCP de tu host (la mayoría de los hosts usan la clave mcpServers):

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

El bloque env sirve para establecer las claves de los proveedores fuera de Claude Code. GPT y Gemini no leen las claves aquí: usan las CLI codex y agy (con la sesión iniciada por separado), así que elimina esas líneas si solo usas GPT/Gemini. XAI_API_KEY habilita Grok; OPENROUTER_API_KEY habilita OpenRouter (que además necesita modelos declarados en ~/.config/deliberation/config.json - la ruta XDG canónica, Windows %APPDATA%\deliberation\config.json - o apunta a otra ubicación con DELIBERATION_CONFIG). Los botones de un clic de arriba no pueden transportar secretos: añade el bloque env a mano después de instalar.

Ubicación de configuración por host y la clave que espera:

Los requisitos previos de los proveedores son los mismos que los del plugin (consulta Requisitos): la CLI de Codex para GPT, agy para Gemini, XAI_API_KEY para Grok y OPENROUTER_API_KEY más ~/.config/deliberation/config.json para OpenRouter (Windows: %APPDATA%\deliberation\config.json; sobrescribe la ruta de configuración con DELIBERATION_CONFIG).

Herramientas expuestas: ask-all, consensus (el bucle de convergencia completo en una sola llamada, o una única pasada de síntesis con synthesizeAlways:true), consensus-step (manejas el bucle tú mismo, una acción por llamada), ask-gpt / ask-gemini / ask-grok / ask-openrouter, panel + ask-one (descubre el conjunto de proveedores activos y luego llama a los proveedores individualmente: ejecútalas en paralelo para ver el progreso de cada proveedor), analyze (ejecuta análisis de solo lectura sobre el registro de depuración y las sesiones: latencia por modelo / tokens + acuerdo de veredictos, con sugerencias de ajuste orientativas; configuredOnly y since limitan el informe a los modelos que todavía usas y a un período que elijas), los siete expertos (architect, plan-reviewer, scope-analyst, code-reviewer, security-analyst, researcher, debugger) y las herramientas de sesión (session-get / session-revisit / session-annotate). Cada resultado incluye ms y el reasoningEffort efectivo (los proveedores HTTP añaden el usage de tokens). Un registro de depuración opcional ("debug": { "enabled": true }) registra latencia / tokens / votos, nunca prompts ni respuestas. Estas herramientas son del lado del servidor, así que funcionan en todos los hosts MCP, no solo en Claude Code (consulta AGENTS.md).

El paquete también incluye un binario deliberation-setup. Ejecútalo una vez con npx -y --package @antonbabenko/deliberation-mcp deliberation-setup para escribir un ~/.config/deliberation/config.json inicial (nunca sobrescribe uno existente). La forma simple npx -y @antonbabenko/deliberation-mcp ejecuta el binario predeterminado (el servidor), que es lo que lanza tu host MCP. Para la configuración de reglas por host, consulta AGENTS.md y los fragmentos por host en examples/.

Plugins nativos por host (Cursor / Codex / Kiro / OpenCode)

Además de la configuración MCP en bruto anterior, deliberation incluye artefactos de plugin nativos para cuatro hosts, de modo que la experiencia coincida con la del plugin de Claude Code (expertos con personalidad + guía sobre cuándo delegar, no solo herramientas sueltas). Todos ellos se generan a partir de las fuentes canónicas con node scripts/sync-hosts.js y se confirman, por lo que nunca se desvían (una prueba CI de desviación lo impone). Cada host escanea el repositorio en busca de sus propios archivos:

Las credenciales de los proveedores funcionan igual que en el servidor independiente (GPT mediante Codex CLI, Gemini mediante agy, XAI_API_KEY para Grok, OPENROUTER_API_KEY para OpenRouter): configura solo los proveedores que uses. El servidor MCP ya inyecta cada persona experta en el lado del servidor, así que estos archivos nativos añaden la superficie de comandos/control del host, no lógica duplicada.

Guías completas por host: docs/hosts/ - Cursor, Codex CLI, Kiro, OpenCode.

Requisitos

Necesitas al menos un proveedor:

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

• Antigravity CLI: Primeros pasos con Antigravity CLI y Migración desde Gemini CLI, luego ejecuta agy e inicia sesión.

• Grok (xAI): no hay CLI que instalar; el puente viene con el plugin (necesita Node 18+). Configura XAI_API_KEY (consigue una clave en https://console.x.ai).

• OpenRouter: no hay CLI; el puente viene con el plugin (necesita Node 18+). Configura OPENROUTER_API_KEY (consigue una clave en https://openrouter.ai/keys) y luego declara los modelos en ~/.config/deliberation/config.json (Windows: %APPDATA%\deliberation\config.json; anula con DELIBERATION_CONFIG). Funciona con cualquier endpoint compatible con OpenAI (Ollama, vLLM, LM Studio, HuggingFace Inference): la autenticación se omite automáticamente cuando la variable de entorno de la clave está vacía.

Nota para Windows (proveedores CLI). npm install -g en Windows instala un codex.cmd, no un ejecutable, y Node no puede lanzar un .cmd directamente, así que las llamadas a GPT solían fallar con un error de spawn. deliberation ahora resuelve la CLI por sí mismo (PATHEXT, con respaldo al punto de entrada del propio paquete) y la mantiene fuera de un shell. Si la resolución falla en tu máquina, apunta CODEX_BIN (GPT) o AGY_BIN (Gemini) al ejecutable real. Grok y OpenRouter no se ven afectados: son puentes HTTP y no generan procesos.

Comandos

Incluidos con el plugin (disponibles una vez instalado):

/setup también puede instalar alias cortos (/ask-gpt, /ask-gemini, /ask-grok, /ask-openrouter, /ask-all, /consensus) en ~/.claude/commands/. Esto es opcional. Los comandos existentes con el mismo nombre se conservan por defecto; setup pregunta antes de sobrescribir cualquiera de ellos. /deliberation:uninstall elimina un alias solo si es byte-idéntico a la copia incluida.

analyze se excluye deliberadamente: /analyze es un nombre común y un alias simple chocaría con cualquier otro plugin que incluya uno. Usa /deliberation:analyze, que siempre está disponible. Si una instalación anterior creó ~/.claude/commands/analyze.md, setup ahora te indica la ruta para que puedas eliminarlo. /deliberation:uninstall también lista analyze, pero su guarda de byte-identidad solo coincide con una copia del archivo actual incluido: un alias copiado de una versión anterior diferirá y se deja intacto deliberadamente en lugar de eliminarlo a ciegas.

Los expertos

Cuándo ayudan más los expertos

• Decisiones de arquitectura - "¿Debería usar Redis o caché en memoria?"

• Atascado en la depuración - después de dos o más intentos fallidos, consigue una perspectiva nueva

• Antes de implementar - valida un plan antes de escribir código

• Preocupaciones de seguridad - "¿Es seguro este flujo de autenticación?"

• Calidad del código - una segunda opinión sobre tu implementación

Cuándo no usar expertos

• Operaciones simples con archivos (Claude las maneja directamente)

• Primer intento de cualquier corrección (inténtalo tú primero)

• Preguntas triviales (no hace falta delegar)

Cómo usar

Describe tu tarea. Claude detecta cuándo un experto ayuda y delega automáticamente:

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

También puedes pedirlo explícitamente: "Pídele a GPT que revise esta arquitectura", "Pídele a Gemini que...", o "Pídele a Grok que...". Cada experto se ejecuta en modo solo lectura para análisis o con acceso de escritura para aplicar correcciones, y Claude elige el modo según tu solicitud.

O invoca los comandos de barra directamente; consulta Comandos arriba.

Cómo /consensus y /ask-* mantienen honestos a los modelos

/ask-gpt, /ask-gemini, /ask-grok y /ask-all son los comandos rápidos: cada uno envía una o tres consultas a modelos externos, Claude lee la salida y obtienes una respuesta sintetizada. Una sola pasada, sin bucle, sin ronda entre pares.

/consensus es el pesado. El mismo envío en paralelo, pero con una ronda de revisión entre pares y un bucle de múltiples rondas que solo se detiene cuando los modelos coinciden. El coste: el orquestador (Claude) escribe el prompt de revisión, emite un voto, decide qué objeciones son reales y ejecuta el bucle. Si se deja solo, esa configuración puede aprobar silenciosamente su propio plan. Cuatro guardas lo impiden.

Consulta el diagrama detallado con las guardas de sesgo y el flujo por modelo

Las cuatro guardas:

• Veredicto ciego. Claude publica su propio veredicto (APROBAR / SOLICITAR CAMBIOS / RECHAZAR) en un mensaje enviado antes del que convoca al panel. El compromiso previo queda en la transcripción, así que Claude no puede reformar su opinión después de ver la de los demás. El motor lo impone: el panel no se revela hasta que se registra el veredicto ciego.

• Revisión entre pares. Cada modelo externo revisa el plan de forma independiente y devuelve un veredicto más los problemas críticos categorizados; Claude los sopesa como árbitro. Los modelos votan, Claude adjudica.

• Sin autoaprobación. Una ronda converge solo cuando todos los externos que responden aprueban y al menos un externo respondió de verdad. La aprobación de Claude nunca lleva una ronda por sí sola. Un proveedor que falla (por ejemplo, un Grok sin configurar que devuelve missing-auth) se descarta del recuento en lugar de bloquear el bucle.

• Sin descarte silencioso. Cada problema crítico que se descarta o se aplaza viaja con una razón de una línea en el informe final, incluidos los casos en que Claude retira una de sus propias objeciones ciegas. El motor rechaza una adjudicación que descarte un problema sin dar una razón.

Los comandos /ask-* llevan una versión más ligera de la misma regla. El modelo externo solo asesora: Claude lee la salida, aplica su propio criterio y es dueño de la respuesta sintetizada. Cuando los modelos coinciden, eso es información, no un veredicto.

/consensus es un controlador fino sobre el motor central de convergencia (core/consensus-loop.js); la mecánica del bucle (recuento de rondas, la regla de convergencia, el límite configurable de rondas máximas, el historial y la etiqueta de confianza) vive en el motor, no en el comando. Cada ronda:

1. Veredicto ciego. Claude emite su propio veredicto (visible en la transcripción) ANTES de que se revele el panel; el motor condiciona la revelación a ello.

2. Revisión del panel. GPT, Gemini, Grok (y cualquier delegado de OpenRouter configurado) revisan el plan en paralelo y emiten APPROVE / REQUEST CHANGES / REJECT junto con problemas críticos categorizados. El servidor analiza cada veredicto.

3. Adjudicación del árbitro + revisión. Claude concilia los veredictos del panel y su propio veredicto ciego; para cada problema crítico elige aceptar, descartar (se requiere motivo) o diferir, y luego revisa el plan para la siguiente ronda.

El bucle converge cuando al menos un externo que responde aprueba, ninguno rechaza, no quedan problemas críticos aceptados y Claude adjudica APPROVE, por lo que Claude no puede autoaprobarse. De lo contrario, se detiene en consensus.maxRounds (por defecto 5, configurable) como unresolved. La etiqueta de confianza refleja la rapidez con la que se resolvió (ronda 1 = high, 2-3 = medium, 4-5 = low).

El mismo motor respalda los puntos de entrada que usan otros hosts: la herramienta consensus (ejecuta todo el bucle en el servidor en una sola llamada con un árbitro de proveedor, o un único pase de síntesis con synthesizeAlways:true) y consensus-step (condúcelo tú mismo, una acción por llamada). Consulta TECHNICAL.md para conocer la taxonomía y el contrato del motor.

Una revisión anterior ejecutaba una "Etapa 2" adicional de revisión cruzada anónima entre pares (cada modelo puntuaba las respuestas de los demás a ciegas, adaptado de karpathy/llm-council). La reescritura impulsada por el motor la eliminó para mantener una única fuente de verdad; podría volver como una función del motor.

Configuración

La referencia completa de instalación y configuración está en SETUP.md. Cubre:

• Modos de experto - asesoramiento (read-only) frente a implementación (workspace-write), elegidos automáticamente según tu solicitud

• Archivo de configuración - ubicación (~/.config/deliberation/config.json), la anulación DELIBERATION_CONFIG y la recarga en caliente

• Las seis secciones de configuración - providers, models, routing, consensus, sessions, debug - con un ejemplo mínimo

• Modelos de OpenRouter - declaración de registros, elegibilidad de askAll / consensus, fan-out, reasoningEffort y selección del árbitro; consensus también configura el límite de rondas (maxRounds) y el presupuesto de tiempo real (maxWallMs, por defecto 20 min)

• Tiempos de espera - providers.defaults.timeout eleva el límite por llamada para todos los proveedores a la vez; providers.<name>.timeout anula uno, y el models.<id>.timeout de un modelo fijado sigue teniendo prioridad. Una llamada limitada por tasa (HTTP 429) se reintenta una vez, respetando el Retry-After del upstream

• Registro de depuración - seguimiento de latencia / tokens / votación opcional

• Persistencia de sesiones - historial de ejecuciones en disco opcional (incluido el bucle /consensus impulsado por el host) y las herramientas session-*; sessions.captureText (desactivado por defecto) además almacena los cuerpos de respuesta de los proveedores (depurados)

Para los detalles internos de los proveedores, las variables de entorno y la configuración manual de MCP, consulta TECHNICAL.md.

Autor

Mantenido por Anton Babenko - LinkedIn, X/Twitter.

Contribuciones

Las contribuciones son bienvenidas. Consulta CONTRIBUTING.md para conocer el flujo de trabajo, las convenciones de commits y el proceso de publicación automatizado.

Licencia

MIT