Consilium Principis

English · Русский

Consilium Principis

Várias perspectivas. Uma decisão. Citações verificadas na fonte.

Um conselho consultivo de IA para Claude Code e hosts MCP. Pergunte sobre uma escolha difícil: os conselheiros a examinam por diferentes lentes, desafiam uns aos outros e lhe dão um próximo passo. Uma linha marcada com 🔵 é verificada por código, palavra por palavra, contra o texto-fonte. Se a linha estiver ausente, o conselheiro não a apresenta como citação.

Exemplo: "O que Marco Aurélio diria sobre isso?" O Consilium pode rotular a interpretação do modelo como 🟡, mostrar uma passagem verificada na fonte 🔵, ou recusar-se a citar quando o corpus não a sustenta. Veja a recusa e verificação ao vivo →

Início rápido no Claude Code

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

Depois pergunte: "Ajude-me a decidir no que focar." Para Claude Desktop, outros hosts MCP e configuração local, veja Instalação. O plugin usa seu agente existente; cobranças de modelo/provedor, se houver, seguem a configuração do seu host.

Explore: Veja uma sessão · Como funciona a verificação de citações · Instalação · Limites

O que é isto

Consilium Principis é uma skill e servidor MCP para agentes de IA. Você o conecta ao seu agente, faz uma pergunta sobre a qual precisa decidir, e ele reúne um conselho ao redor da mesa: Sun Tzu, Marco Aurélio, Maquiavel, Epicteto, e quem mais você adicionar. Cada um olha através de sua própria lente, apoia-se em seus próprios textos e argumenta — com você e com os outros. No final, você recebe uma síntese e um próximo passo. E se a pergunta for quantificável ("o que vale mais a pena, X ou Y"), o conselho não resolve no olho — ele decompõe a decisão em números e os processa via Monte Carlo.

Este projeto não pede que uma IA interprete um sábio — tentamos construir uma ferramenta, não um jogo de interpretação ou um gerador de aforismos. Por que você pode confiar em suas citações vem a seguir.

Uma coisa honesta sobre quem está à mesa: estes não são os pensadores em si, mas suas versões de IA — um prisma de suas visões sobre o corpus de seus textos públicos. Ninguém está "falando do além-túmulo." Um conselheiro mantém a lente do autor e apoia-se em suas palavras, mas continua sendo um modelo — e dizemos isso claramente.

O Consilium não precisa de chave de API separada. Ele roda no agente que você já tem, cujo modelo ou provedor pode ter suas próprias cobranças. Verificar citações não precisa de internet; uma configuração totalmente offline exige modelos locais.

Como difere de outros conselhos

O mecanismo de "várias IAs deliberando" já é comum. O que diferencia o Consilium não é o número de vozes. É que uma afirmação pode ser reverificada, e onde não pode, o conselho honestamente permanece em silêncio:

	"Interpretar um sábio" (uma IA)	Conselho estilo LLM-Council	Consilium
Lentes diferentes, discordância como recurso	±	✅	✅
Citação verbatim verificada palavra por palavra contra o original, com sua fonte	✗	✗	✅
Silêncio honesto fora do corpus (fail-closed)	✗	✗	✅
Pergunta quantificável → Monte Carlo (📐)	✗	✗	✅
Nenhuma chave separada exigida pelo projeto	±	±	✅

_{Um "conselho pessoal de diretores" é uma prática comum (um conceito da HBR); a aposta em fundamentação e transparência de citação foi validada tanto pelo mercado (Delphi, US$ 16M da Sequoia) quanto pela academia (debate multi-persona, o benchmark ALCE). Nosso diferencial é o rigor: uma citação verificável e uma recusa honesta.}

Como parece

Você pergunta em palavras simples:

"Estou equilibrando quatro direções ao mesmo tempo. No que devo focar?"

E em vez de uma resposta suave e cheia de ressalvas, você recebe uma sessão onde cada conselheiro olha de seu próprio ponto de vista, e eles discordam:

Sun Tzu (lente "Estrategista") 🟡 "Quem é forte em toda parte não é forte em lugar nenhum. Das quatro frentes, escolha aquela onde você tem vantagem, concentre seu peso ali; mantenha o resto no mínimo."

Maquiavel 🟡 "Espalhado, você é fraco em todas as frentes e vulnerável em todas elas. A pergunta não é 'o que crescer', mas 'o que você está disposto a abrir mão'. Essa é a decisão."

Marco Aurélio 🔵 "Que seja teu cuidado sério e incessante, como romano e como homem, realizar tudo aquilo que tens em mãos" (Meditações, trad. Long). Faça a coisa diante de você por inteiro; quatro coisas ao mesmo tempo é dispersão. ↳ e pergunte a ele algo que não está em seus textos, e ele honestamente permanecerá em silêncio em vez de inventar uma citação.

Em seguida vem a síntese (onde eles realmente concordam) e um próximo passo concreto. A discordância aqui é um recurso: você vê a decisão por ângulos que teria perdido sozinho. E se a pergunta for quantificável ("o que vale mais a pena, X ou Y"), o conselho oferecerá não discutir no olho, mas calcular (veja 📐 abaixo).

_{O exemplo é ilustrativo, e os conselheiros são representações de IA construídas a partir de textos, não os próprios autores. 🟡 = um pensamento no espírito do autor (o modelo raciocina através de sua lente), 🔵 = uma linha verbatim com fonte no corpus. Todos os exemplos são figuras de domínio público (Sun Tzu, Aurélio, Maquiavel, Epicteto); quem se senta à SUA mesa é sua escolha. Suas sessões reais são gravadas em council/ localmente e nunca vão para o git (veja design técnico).}

O que você pode perguntar

Não precisa aprender comandos. Diga "o que você sabe fazer?" e o conselho mostrará um menu. Por exemplo:

• "O que pode dar errado no meu lançamento?" um premortem: onde vai quebrar, o que reforçar com antecedência
• "O que Aurélio diria sobre burnout?" um único conselheiro, estritamente a partir de seus textos
• "Faça Sun Tzu e Maquiavel discutirem sobre X" coloque dois pontos de vista um contra o outro
• "O que vale mais a pena, voltar a um emprego assalariado ou continuar com meu próprio negócio?" 📐 um mapa de decisão: decomponha em números e calcule (em vez de discutir no olho)
• "Ajude-me a vencer esta discussão" uma análise de posição como um motor de xadrez: seus movimentos, contra-ataques, um veredito honesto
• "Estou me contradizendo?" um espelho: o que você diz vs. o que você realmente escolhe

Por que você pode confiar nisto

Isto não é "um chatbot fingindo ser sábio." Cada palavra é marcada por um contorno protetor.

A prova real não está no tom, mas na verificabilidade: uma citação verbatim (🔵) é verificada contra o corpus genuíno do autor por código, palavra por palavra, e traz uma fonte. Se a linha exata não for encontrada, o conselheiro honestamente permanece em silêncio (fail-closed) em vez de inventá-la. É isso que separa uma ferramenta de decisão de "interpretar um sábio": cada afirmação pode ser reverificada.

Marcador	O que significa
🔵	citação verbatim do corpus genuíno do autor, verificada palavra por palavra, com fonte
🟢	verbatim, mas de comentário/interpretação (não na voz do próprio autor), com o comentarista nomeado
🟡	no espírito do autor, mas não suas palavras exatas, honestamente marcado
📐	cálculo: seus próprios números, processados via Monte Carlo; não é verdade, não é citação, apenas seu próprio modelo executado N vezes
abstenção	pergunta fora do corpus → o conselheiro permanece em silêncio em vez de inventar

Além disso, lentes diferentes, não um coro: cada conselheiro mantém seu próprio ângulo, e sua discordância é uma parte funcional, não um bug. Você vê a decisão por lados que de outra forma colapsariam em um só.

O contorno de honestidade em si é código, não um modelo: ele verifica cada citação contra sua fonte em qualquer máquina, sem chaves, sem custo. Sem semântica, apenas a precisão da busca enfraquece — a honestidade nunca. A relevância do candidato é pontuada por um portão de duas fases: um modelo julga, o código aplica o limite, então material tematicamente próximo mas que não responde de fato não passará como 🔵. Por padrão, o host faz essa pontuação — uma parte interessada, o que doctor rotula honestamente; quer um juiz independente, conecte um backend local (ollama) ou de API, uma escolha explícita. O backend de API é OpenRouter (openrouter.ai) com seu próprio OPENROUTER_API_KEY: a consulta e as passagens candidatas são enviadas para lá para pontuação. Nada sai da sua máquina a menos que você ative. O portão verbatim 🔵 nunca depende do juiz: o código o mantém.

Calcule, não apenas discuta: o mapa de decisão 📐

O conselho tem dois modos. O primeiro é uma sessão (discutir, desafiar, sintetizar). O segundo entra em ação em uma pergunta de decisão quantificável ("o que vale mais a pena", "vale a pena", "X ou Y"): em vez de uma resposta no olho, o conselho decompõe a escolha em um mapa de decisão, ou seja, opções, quantidades (seus próprios números, obtidos como estimativas de três pontos "pior / típico / melhor", para evitar ancoragem) e fórmulas. Depois vem o Monte Carlo determinístico (o código faz a matemática, zero LLM no cálculo, mesma semente dá o mesmo resultado): P(melhor opção), um gráfico de sensibilidade tornado, o que realmente impulsiona o resultado. Uma opção "não fazer nada" é obrigatória. Decompor com um premortem ("um ano se passou, falhou, por quê?") e um 2×2 sobre as incertezas-chave também é algo que o conselho faz. Tudo fica sob o rótulo 📐, ao lado de 🔵/🟢/🟡, mas nunca misturado: isto não é sabedoria, é seu próprio modelo, executado numericamente. E se você registrar a decisão, depois o conselho verificará a previsão contra o que realmente aconteceu (o loop de resultado: calibrando seu modelo, não "palpite certo ou errado").

Por padrão, claramente humano: o conselho responde no seu idioma e dá um resultado final limpo, sem números extras. Uma citação 🔵 permanece no original (para que possa ser verificada), com uma tradução ao lado. Precisa do detalhamento completo (probabilidades, robustez da posição, marcação fonte por fonte), basta dizer "mostre-me os detalhes."

Instalação

Via plugin do Claude Code (recomendado)

No Claude Code:

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

O Claude Code iniciará o servidor MCP e registrará a skill. Depois diga "por onde começo", e o concierge verificará a prontidão e montará um conselho inicial (Marco Aurélio e Epicteto, domínio público).

Via skills.sh (CLI)

Do registro skills.sh, um comando instala o funil de integração enxuto:

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

Isto instala apenas a skill de guia consilium-connect: ela explica que um servidor MCP local é necessário e orienta você a conectá-lo (veja os caminhos acima ou CONNECT-MCP.md). O conselho e todas as ferramentas vivem no servidor, não neste markdown — um canal de descoberta, não uma instalação funcional.

Ou uma instalação simples

A maneira mais simples, deixe o Claude instalar por você. Abra o Claude Code e dê a ele o link:

"Instale esta skill para mim: https://github.com/ilyautov/consilium-principis"

O Claude clonará o repositório, executará python3 install.py (uma cópia vai para ~/.claude/skills/, com autoverificação incluída) e reportará de volta. Sem chaves, sem terminal. Depois diga "por onde começo", e ele montará um conselho inicial (Marco Aurélio e Epicteto, domínio público) em alguns minutos.

Não funcionou na primeira tentativa? Dê ao Claude isto verbatim:

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

Prefere botões ou um terminal? Veja QUICKSTART.en.md: uma instalação por clique (install.command / .bat) e o caminho manual.

Ou o pacote Claude Desktop

A versão traz um pacote .mcpb de arquivo único — uma extensão do Claude Desktop. Baixe-o e, no Claude Desktop, abra Configurações → Extensões → instalar a partir do arquivo. Usuários do Claude Code não precisam dele; os caminhos acima são suficientes. Detalhes de integração para outros hosts MCP estão em CONNECT-MCP.en.md.

Para atualizar, execute a instalação novamente (ela faz merge, preservando seu quadro advisors/). Para desinstalar: se você instalou como plugin, execute /plugin uninstall consilium-principis no Claude Code; se instalou via script, exclua ~/.claude/skills/consilium-principis.

Claude Desktop ou outro host MCP: o servidor expõe seu ciclo (build, sessões, widgets) como ferramentas. A compatibilidade com hosts varia; consulte a tabela de status testado em docs/CONNECT-HOSTS.en.md e, em seguida, gere a configuração portátil a partir do checkout com python3 scripts/board.py mcp-config --json.

Tudo o que você precisa: Python 3.10+. Para busca inteligente entre idiomas, opcionalmente ollama com bge-m3 (o quadro vai te guiar na configuração). O contorno funciona sem ele também.

Windows

O Windows ainda não é um alvo de suporte testado de ponta a ponta. install.bat e o pacote mcpb contêm um caminho de launcher para Windows, mas trate-o como experimental e reporte o resultado através do Suporte. Duas coisas específicas do Windows que vale saber:

• No terminal, use py install.py (não python3 install.py). O instalador do python.org traz py.exe e python.exe, mas não python3.exe; o python3.exe que você pode ver na Microsoft Store é um stub de Alias de Execução de Aplicativo que só abre a Store em vez de executar.
• O plugin não encontra o Python? Defina CONSILIUM_PYTHON=py no seu ambiente antes de iniciar o Claude Code. O comando do servidor do plugin usa como padrão python3 e respeita essa substituição. (O caminho do Claude Desktop não precisa de nada — o board.py mcp-config escreve o interpretador exato para você.)
• Configuração do MCP: execute py -3 scripts/board.py mcp-config --json (ou py -3 scripts/board.py mcp-install para Claude Desktop). Se py estiver ausente, use python somente após confirmar que é Python 3.10+; não use o alias python3 da Store. Veja CONNECT-MCP.en.md para o fallback exato.

Seu quadro, sua decisão

Um quadro vazio logo de cara é normal. Quem senta à mesa é você quem decide; o quadro é pessoal. Sábios de domínio público (os estoicos, Sun Tzu) são montados com uma frase. Pensadores modernos vêm de materiais que você mesmo traz.

⚖️ Limite. Consilium é um motor de fidelidade, não um distribuidor de conteúdo: ele entrega a maquinaria, você traz as fontes. A skill não baixa livros protegidos por direitos autorais. Domínio público é usado livremente; direitos autorais significam apenas suas próprias cópias legais, que ficam na sua máquina. Os sábios que enviamos pré-montados são figuras de domínio público falecidas há muito tempo; qualquer pessoa moderna você constrói você mesmo. Seu quadro (advisors/) e seu perfil são dados pessoais; eles nunca vão para o repositório.

Como é construído

A busca tem dois níveis de suporte: SIMPLE é o piso lexical da biblioteca padrão; FULL adiciona Ollama com bge-m3 para busca semântica entre idiomas. A recuperação híbrida é opcional, não um terceiro nível de suporte. O contorno protetivo é separado: ele verifica cada citação contra sua fonte, independentemente do nível selecionado. Detalhes em SKILL.md (em russo) e no docs/MANUAL.md gerado (em russo).

Design técnico

O manual técnico completo (o que é isso, arquitetura, referência de ferramentas/regras, como estender) está em docs/MANUAL.md. Ele é gerado a partir do código (scripts/gen_selfdoc.py → scripts/build_manual.py); em tempo de execução, a mesma informação está disponível via a ferramenta MCP explain_self.

FAQ

O que é Consilium Principis? Consilium Principis é um conselho consultivo de IA de código aberto — uma skill para Claude Code e um servidor MCP — que reúne um painel de personas de IA de pensadores reais (Sun Tzu, Marco Aurélio, Maquiavel, Epicteto e qualquer um que você adicionar) para raciocinar sobre uma decisão. Sua característica distintiva é um contorno de fidelidade: toda citação literal é verificada contra o texto genuíno do autor, ou o conselheiro se abstém.

Como ele verifica citações? Cada citação 🔵 é verificada por código contra o corpus de domínio público do autor, palavra por palavra. Se uma afirmação não for encontrada no texto-fonte, o conselheiro não a apresenta como citação — ele permanece em silêncio (fail-closed) em vez de inventar uma. Você a reverifica, não a aceita por fé.

Como isso é diferente de pedir a uma IA para interpretar um sábio? Um chatbot de roleplay vai fabricar feliz uma citação que parece plausível. Consilium ou prova a citação contra o texto real ou recusa atribuí-la. Discordância entre conselheiros é uma característica, não um bug: cada um fala através de uma lente diferente.

Precisa de chave de API ou pagamento extra? O Consilium em si não precisa de chave separada ou assinatura. Ele usa seu agente existente, cujo modelo ou provedor pode ter seus próprios custos. A verificação de citações não precisa de rede; operação totalmente offline requer modelos locais.

Quais pensadores estão incluídos, e posso adicionar os meus? Figuras de domínio público (os estoicos, Sun Tzu, Maquiavel) são montadas a partir de seus próprios textos com uma frase. Você pode adicionar qualquer conselheiro você mesmo, a partir de materiais de domínio público ou seus próprios materiais legais, que ficam na sua máquina — o repositório entrega apenas a maquinaria, nunca fontes protegidas por direitos autorais.

É gratuito e de código aberto? Sim. É licenciado sob MIT e de código aberto. Instale com /plugin marketplace add ilyautov/consilium-principis.

Contribuição e segurança

PRs são bem-vindos, mas duas regras são inegociáveis: apenas textos de domínio público (sem material protegido por direitos autorais, nem mesmo trechos) e nunca enfraqueça o contorno fail-closed (🔵 apenas via verificação por código). Como configurar, rodar a suíte offline e abrir um PR está em CONTRIBUTING.en.md. Encontrou uma forma de contornar o contorno de fidelidade ou um vazamento de dados? Isso é uma vulnerabilidade de primeira classe; reporte-a em privado via SECURITY.en.md. Suporte e governança do projeto estão em SUPPORT.md e GOVERNANCE.md; o histórico de mudanças está em CHANGELOG.md.

---

---

Quem construiu isso

Ilya Utov, o laboratório AI Frontier. Escrevo sobre como essas ferramentas funcionam internamente no Telegram e no LinkedIn.

Por perto:

• humanizer-ru: remove a impressão digital de IA de textos em russo
• marketplaces-mcp-ru: Wildberries, Ozon, Yandex Market e Avito direto do agente
• small-business-ru: 34 skills para pequenas empresas russas, com os números calculados em código
• hefest: segurança química para uma planta industrial, mantida dentro da própria rede da planta
• cordon: uma camada determinística entre conteúdo não confiável e ações do agente

Tudo em uma lista, agrupado pelo que faz: ilyautov.github.io. Código-fonte: github.com/ilyautov. Útil? Dê uma estrela, é assim que outras pessoas encontram.