Consilium Principis

Español · Русский

Consilium Principis

Varias perspectivas. Una decisión. Citas verificadas contra la fuente.

Un consejo asesor de IA para Claude Code y hosts MCP. Pregunta sobre una decisión difícil: los asesores la examinan desde diferentes lentes, se desafían entre sí y te dan un siguiente paso. Una línea marcada con 🔵 es verificada por código contra el texto fuente palabra por palabra. Si la línea no está presente, el asesor no la presenta como cita.

Ejemplo: "¿Qué diría Marco Aurelio sobre esto?" Consilium puede etiquetar la interpretación de un modelo como 🟡, mostrar un pasaje verificado contra la fuente 🔵, o negarse a citar cuando el corpus no lo respalda. Mira el rechazo y la verificación en vivo →

Inicio rápido en Claude Code

/plugin marketplace add ilyautov/consilium-principis
/plugin install consilium-principis@consilium-marketplace

Luego pregunta: "Ayúdame a decidir en qué enfocarme." Para Claude Desktop, otros hosts MCP y configuración local, consulta Instalación. El plugin usa tu agente existente; los cargos del modelo/proveedor, si los hay, siguen la configuración de tu host.

Explora: Ver una sesión · Cómo funciona la verificación de citas · Instalación · Límites

Qué es esto

Consilium Principis es una habilidad y un servidor MCP para agentes de IA. Lo conectas a tu agente, haces una pregunta sobre la que necesitas decidir, y reúne un consejo alrededor de la mesa: Sun Tzu, Marco Aurelio, Maquiavelo, Epicteto, y quien más quieras añadir. Cada uno lo mira desde su propio lente, se apoya en sus propios textos, y argumenta — contigo y con los demás. Al final obtienes una síntesis y un siguiente paso. Y si la pregunta es cuantificable ("¿qué vale más la pena, X o Y?"), el consejo no lo estima a ojo — descompone la decisión en números y los ejecuta mediante Monte Carlo.

Este proyecto no le pide a una IA que interprete a un sabio — intentamos construir una herramienta, no un juego de rol ni un generador de aforismos. Por qué puedes confiar en sus citas viene a continuación.

Una cosa honesta sobre quién está en la mesa: estos no son los pensadores mismos sino sus versiones de IA — un prisma de sus puntos de vista sobre el corpus de sus textos públicos. Nadie "habla desde el más allá." Un asesor sostiene el lente del autor y se apoya en sus palabras, pero sigue siendo un modelo — y lo decimos claramente.

Consilium no necesita una clave API separada. Se ejecuta en el agente que ya tienes, cuyo modelo o proveedor puede tener sus propios cargos. Verificar citas no necesita internet; una configuración completamente offline requiere modelos locales.

Cómo se diferencia de otros consejos

El mecanismo de "varias IAs deliberan" ya es común. Lo que distingue a Consilium no es el número de voces. Es que una afirmación puede ser re-verificada, y donde no puede, el consejo honestamente permanece en silencio:

	"Interpreta a un sabio" (una IA)	Consejo estilo LLM-Council	Consilium
Diferentes lentes, desacuerdo como característica	±	✅	✅
Cita textual verificada palabra por palabra contra el original, con su fuente	✗	✗	✅
Silencio honesto fuera del corpus (fail-closed)	✗	✗	✅
Pregunta cuantificable → Monte Carlo (📐)	✗	✗	✅
Sin clave separada requerida por el proyecto	±	±	✅

_{Un "consejo de directores personal" es una práctica convencional (un concepto de HBR); la apuesta por la fundamentación y la transparencia de citas ha sido validada tanto por el mercado (Delphi, $16M de Sequoia) como por la academia (debate multi-persona, el benchmark ALCE). Nuestro ángulo es el rigor: una cita verificable y un rechazo honesto.}

Cómo se ve

Preguntas en palabras simples:

"Estoy haciendo malabares con cuatro direcciones a la vez. ¿En qué debería enfocarme?"

Y en lugar de una respuesta suave y evasiva, obtienes una sesión donde cada asesor mira desde su propio punto de vista, y no están de acuerdo:

Sun Tzu (el lente "Estratega") 🟡 "Quien es fuerte en todas partes no es fuerte en ninguna. De los cuatro frentes, elige aquel donde tengas ventaja, lanza tu peso allí; mantén el resto al mínimo."

Maquiavelo 🟡 "Repartido, eres débil en todos los frentes y vulnerable en todos. La pregunta no es 'qué hacer crecer' sino 'a qué estás dispuesto a renunciar'. Esa es la decisión."

Marco Aurelio 🔵 "Que sea tu cuidado serio e incesante, como romano y como hombre, realizar todo aquello que tienes entre manos" (Meditaciones, trad. Long). Haz la cosa que tienes delante por completo; cuatro cosas a la vez es dispersión. ↳ y pregúntale algo que no esté en sus textos, y honestamente permanecerá en silencio en lugar de inventar una cita.

Luego viene la síntesis (donde realmente coinciden) y un siguiente paso concreto. El desacuerdo aquí es una característica: ves la decisión desde ángulos que habrías pasado por alto por tu cuenta. Y si la pregunta es cuantificable ("¿qué vale más la pena, X o Y?"), el consejo ofrecerá no discutir a ojo sino calcular (ver 📐 abajo).

_{El ejemplo es ilustrativo, y los asesores son representaciones de IA construidas a partir de textos, no los autores mismos. 🟡 = un pensamiento en el espíritu del autor (el modelo razona a través de su lente), 🔵 = una línea textual con una fuente en el corpus. Todos los ejemplos son figuras de dominio público (Sun Tzu, Aurelio, Maquiavelo, Epicteto); quién se sienta en TU mesa es tu decisión. Tus sesiones reales se escriben en council/ localmente, y nunca van a git (ver diseño técnico).}

Qué puedes preguntar

No necesitas aprender comandos. Di "¿qué puedes hacer?" y el consejo mostrará un menú. Por ejemplo:

• "¿Qué podría salir mal con mi lanzamiento?" un premortem: dónde fallará, qué apuntalar de antemano
• "¿Qué diría Aurelio sobre el agotamiento?" un solo asesor, estrictamente desde sus textos
• "Haz que Sun Tzu y Maquiavelo discutan sobre X" enfrenta dos puntos de vista
• "¿Qué vale más la pena, volver a un trabajo asalariado o seguir con lo mío?" 📐 un mapa de decisión: descomponerlo en números y calcular (en lugar de discutir a ojo)
• "Ayúdame a ganar esta discusión" un desglose de posición como un motor de ajedrez: tus movimientos, contramovimientos, un veredicto honesto
• "¿Me estoy contradiciendo?" un espejo: lo que dices vs. lo que realmente eliges

Por qué puedes confiar en esto

Esto no es "un chatbot jugando al sabio." Cada palabra está etiquetada por un contorno protector.

La prueba real no está en el tono sino en la verificabilidad: una cita textual (🔵) es verificada contra el corpus genuino del autor por código, palabra por palabra, y lleva una fuente. Si la línea exacta no se encuentra, el asesor honestamente permanece en silencio (fail-closed) en lugar de inventarla. Eso es lo que separa una herramienta de decisión de "interpretar a un sabio": cada afirmación puede ser re-verificada.

Marcador	Qué significa
🔵	cita textual del corpus genuino del autor, verificada palabra por palabra, con una fuente
🟢	textual, pero de comentario/interpretación (no en la voz del propio autor), con el comentarista nombrado
🟡	en el espíritu del autor, pero no sus palabras exactas, marcado honestamente
📐	cálculo: tus propios números, ejecutados mediante Monte Carlo; no es verdad, no es una cita, solo tu propio modelo ejecutado N veces
abstención	pregunta fuera del corpus → el asesor permanece en silencio en lugar de inventar

Además, diferentes lentes, no un coro: cada asesor mantiene su propio ángulo, y su desacuerdo es una parte funcional, no un error. Ves la decisión desde lados que de otro modo colapsarías en uno solo.

El contorno de honestidad en sí es código, no un modelo: verifica cada cita contra su fuente en cualquier máquina, sin claves, sin costo. Sin semántica, solo la precisión de búsqueda se debilita — la honestidad nunca. La relevancia de los candidatos se puntúa mediante una puerta de dos fases: un modelo juzga, el código aplica el umbral, para que material temáticamente cercano pero que no responde realmente no se cuele como 🔵. Por defecto, el host hace esa puntuación — una parte interesada, que doctor etiqueta honestamente; si quieres un juez independiente, conecta un backend local (ollama) o API, una elección explícita. El backend API es OpenRouter (openrouter.ai) con tu propio OPENROUTER_API_KEY: la consulta y los pasajes candidatos se envían allí para puntuación. Nada sale de tu máquina a menos que lo actives. La puerta textual 🔵 nunca depende del juez: el código la sostiene.

Calcula, no solo discute: el mapa de decisión 📐

El consejo tiene dos modos. El primero es una sesión (discutir, desafiar, sintetizar). El segundo se activa con una pregunta de decisión cuantificable ("qué vale más la pena", "¿vale la pena?", "X o Y"): en lugar de una respuesta a ojo, el consejo descompone la elección en un mapa de decisión, es decir, opciones, cantidades (tus propios números, obtenidos como estimaciones de tres puntos "peor / típico / mejor", para evitar anclaje), y fórmulas. Luego viene Monte Carlo determinista (el código hace las matemáticas, cero LLM en el cálculo, la misma semilla da el mismo resultado): P(mejor opción), un gráfico de sensibilidad tornado, qué impulsa realmente el resultado. Una opción de "no hacer nada" es obligatoria. Descomponerlo con un premortem ("pasó un año, falló, ¿por qué?") y un 2×2 sobre las incertidumbres clave también es algo que el consejo hace. Todo queda bajo la etiqueta 📐, junto a 🔵/🟢/🟡 pero nunca mezclado: esto no es sabiduría, es tu propio modelo, ejecutado numéricamente. Y si registras la decisión, luego el consejo verificará el pronóstico contra lo que realmente sucedió (el bucle de resultados: calibrar tu modelo, no "acertar o fallar").

Por defecto, claramente humano: el consejo responde en tu idioma y da un resultado final limpio sin números extra. Una cita 🔵 permanece en el original (para que pueda verificarse), con una traducción al lado. ¿Necesitas el desglose completo (probabilidades, robustez de la posición, marcado fuente por fuente)? Solo di "muéstrame los detalles."

Instalación

Mediante el plugin de Claude Code (recomendado)

En Claude Code:

/plugin marketplace add ilyautov/consilium-principis /plugin install consilium-principis@consilium-marketplace

Claude Code iniciará el servidor MCP y registrará la habilidad. Luego di "por dónde empiezo", y el conserje verificará la preparación y ensamblará un consejo inicial (Marco Aurelio y Epicteto, dominio público).

Mediante skills.sh (CLI)

Desde el registro de skills.sh, un comando instala el embudo de incorporación ligero:

npx skills add ilyautov/consilium-principis/skills/consilium-connect

Esto instala solo la habilidad de guía consilium-connect: explica que se requiere un servidor MCP local y te guía para conectarlo (ver las rutas anteriores o CONNECT-MCP.md). El consejo y todas las herramientas viven en el servidor, no en este markdown — un canal de descubrimiento, no una instalación funcional.

O una instalación simple

La forma más sencilla, deja que Claude lo instale por ti. Abre Claude Code y dale el enlace:

"Instala esta habilidad para mí: https://github.com/ilyautov/consilium-principis"

Claude clonará el repositorio, ejecutará python3 install.py (una copia aterriza en ~/.claude/skills/, con autoverificación incluida) y te informará. Sin claves, sin terminal. Luego di "por dónde empiezo", y ensamblará un consejo inicial (Marco Aurelio y Epicteto, dominio público) en un par de minutos.

¿No funcionó al primer intento? Dale a Claude esto textualmente:

git clone https://github.com/ilyautov/consilium-principis ~/consilium-principis
cd ~/consilium-principis && python3 install.py

¿Prefieres botones o una terminal? Ver QUICKSTART.en.md: una instalación con un clic (install.command / .bat) y la ruta manual.

O el paquete de Claude Desktop

La versión incluye un paquete de archivo único .mcpb — una extensión de Claude Desktop. Descárgalo y luego en Claude Desktop abre Configuración → Extensiones → instalar desde archivo. Los usuarios de Claude Code no lo necesitan; las rutas anteriores son suficientes. Los detalles de conexión para otros hosts MCP están en CONNECT-MCP.en.md.

Para actualizar, vuelve a ejecutar la instalación (se fusiona, conservando tu tablero advisors/). Para desinstalar: si lo instalaste como plugin, ejecuta /plugin uninstall consilium-principis en Claude Code; si lo instalaste mediante script, elimina ~/.claude/skills/consilium-principis.

Claude Desktop u otro host MCP: el servidor expone su ciclo (build, sesiones, widgets) como herramientas. La compatibilidad con hosts varía; consulta la tabla de estado probado en docs/CONNECT-HOSTS.en.md y luego genera la configuración portátil desde el checkout con python3 scripts/board.py mcp-config --json.

Todo lo que necesitas: Python 3.10+. Para búsqueda inteligente entre idiomas, opcionalmente ollama con bge-m3 (el tablero te guiará en la configuración). El contorno funciona igualmente sin ello.

Windows

Windows aún no es un objetivo de soporte probado de extremo a extremo. install.bat y el paquete mcpb contienen una ruta de lanzador para Windows, pero trátalo como experimental e informa el resultado a través de Soporte. Dos cosas específicas de Windows que vale la pena saber:

• En una terminal, usa py install.py (no python3 install.py). El instalador de python.org incluye py.exe y python.exe, pero no python3.exe; el python3.exe que puedas ver bajo Microsoft Store es un stub de alias de ejecución de aplicaciones que solo abre la Store en lugar de ejecutarse.
• ¿El plugin no encuentra Python? Establece CONSILIUM_PYTHON=py en tu entorno antes de lanzar Claude Code. El comando del servidor del plugin usa por defecto python3 y respeta esta anulación. (La ruta de Claude Desktop no necesita nada — board.py mcp-config escribe el intérprete exacto por ti.)
• Configuración MCP: ejecuta py -3 scripts/board.py mcp-config --json (o py -3 scripts/board.py mcp-install para Claude Desktop). Si py está ausente, usa python solo después de confirmar que es Python 3.10+; no uses el alias python3 de la Store. Consulta CONNECT-MCP.en.md para el respaldo exacto.

Tu tablero, tu decisión

Un tablero vacío de fábrica es normal. Quién se sienta a la mesa es tu decisión; el tablero es personal. Los sabios de dominio público (los estoicos, Sun Tzu) están ensamblados con una frase. Los pensadores modernos provienen de materiales que tú mismo aportas.

⚖️ Límite. Consilium es un motor de fidelidad, no un distribuidor de contenido: incluye la maquinaria, tú aportas las fuentes. La habilidad no descarga libros con derechos de autor. El dominio público se toma libremente; los derechos de autor significan solo tus propias copias legales, que permanecen en tu máquina. Los sabios que incluimos preensamblados son figuras de dominio público fallecidas hace tiempo; cualquier persona moderna la construyes tú mismo. Tu tablero (advisors/) y tu perfil son datos personales; nunca van al repositorio.

Cómo está construido

La búsqueda tiene dos niveles de soporte: SIMPLE es el piso léxico de la biblioteca estándar; FULL añade Ollama con bge-m3 para búsqueda semántica entre idiomas. La recuperación híbrida es opcional, no un tercer nivel de soporte. El contorno protector es separado: verifica cada cita contra su fuente independientemente del nivel seleccionado. Detalles en SKILL.md (en ruso) y el docs/MANUAL.md generado (en ruso).

Diseño técnico

El manual técnico completo (qué es esto, arquitectura, referencia de herramientas/reglas, cómo extenderlo) vive en docs/MANUAL.md. Se genera desde el código (scripts/gen_selfdoc.py → scripts/build_manual.py); en tiempo de ejecución la misma información está disponible a través de la herramienta MCP explain_self.

Preguntas frecuentes

¿Qué es Consilium Principis? Consilium Principis es un consejo asesor de IA de código abierto — una habilidad para Claude Code y un servidor MCP — que reúne un panel de personas de IA de pensadores reales (Sun Tzu, Marco Aurelio, Maquiavelo, Epicteto y cualquiera que agregues) para razonar una decisión. Su característica distintiva es un contorno de fidelidad: cada cita textual se verifica contra el texto genuino del autor, o el asesor se abstiene.

¿Cómo verifica las citas? Cada cita 🔵 se verifica mediante código contra el corpus de dominio público del autor, palabra por palabra. Si una afirmación no se encuentra en el texto fuente, el asesor no la presenta como cita — permanece en silencio (fallo cerrado) en lugar de inventar una. Tú la re-verificas, no la tomas por fe.

¿En qué se diferencia de pedirle a una IA que interprete a un sabio? Un chatbot de rol fabricará felizmente una cita que suene plausible. Consilium o prueba la cita contra el texto real o se niega a atribuirla. El desacuerdo entre asesores es una característica, no un error: cada uno habla a través de una lente diferente.

¿Necesita una clave API o pago adicional? Consilium en sí no necesita clave ni suscripción separada. Usa tu agente existente, cuyo modelo o proveedor puede tener sus propios cargos. La verificación de citas no necesita red; la operación completamente fuera de línea requiere modelos locales.

¿Qué pensadores están incluidos y puedo agregar los míos? Las figuras de dominio público (los estoicos, Sun Tzu, Maquiavelo) están ensambladas desde sus propios textos con una frase. Puedes agregar cualquier asesor tú mismo desde dominio público o tus propios materiales legales, que permanecen en tu máquina — el repositorio incluye solo la maquinaria, nunca fuentes con derechos de autor.

¿Es gratuito y de código abierto? Sí. Tiene licencia MIT y es de código abierto. Instala con /plugin marketplace add ilyautov/consilium-principis.

Contribuciones y seguridad

Las PR son bienvenidas, pero dos reglas son innegociables: solo textos de dominio público (sin material con derechos de autor, ni siquiera extractos) y nunca debilitar el contorno de fallo cerrado (🔵 solo mediante verificación de código). Cómo configurar, ejecutar la suite fuera de línea y abrir una PR está en CONTRIBUTING.en.md. ¿Encontraste una forma de eludir el contorno de fidelidad o una fuga de datos? Es una vulnerabilidad de primera clase, repórtala de forma privada a través de SECURITY.en.md. El soporte y la gobernanza del proyecto están en SUPPORT.md y GOVERNANCE.md; el historial de cambios está en CHANGELOG.md.

---

---

Quién construyó esto

Ilya Utov, el laboratorio AI Frontier. Escribo sobre cómo funcionan estas herramientas por dentro en Telegram y LinkedIn.

Cerca de aquí:

• humanizer-ru: elimina la huella de IA del texto en ruso
• marketplaces-mcp-ru: Wildberries, Ozon, Yandex Market y Avito directamente desde el agente
• small-business-ru: 34 habilidades para pequeñas empresas rusas, los números calculados en código
• hefest: seguridad química para una planta industrial, mantenida dentro de la propia red de la planta
• cordon: una capa determinista entre contenido no confiable y acciones del agente

Todo en una lista, agrupado por lo que hace: ilyautov.github.io. Fuente: github.com/ilyautov. ¿Útil? Dale una estrella, así es como otras personas lo encuentran.