How ilyautov/consilium-principis works
Consilium Principis is an MCP server and agent skill for decision support: a user asks a question through an agent, which uses the server’s tools and the agent’s own reasoning to gather perspectives and produce a synthesis and next step. The documented product also includes exact-quote verification and abstention, quantitative decision maps, premortems, argument analysis, mirrors, and a federation mode. Internally, corpus construction feeds retrieval and quote-fidelity checks. Source excerpts are partial; unsampled feature modules are included only where the README or source index establishes their role, and uncertain connections are omitted.
Main entry points: mcp_server.py MCP tools · pipeline.py Corpus publishing · retrieval.py Passage retrieval · coordinator.py Federation coordinator
Components 22
Agent interaction
- MCP tools
scripts/mcp_server.py - Advisor lenses
scripts/build_advisor.py - Session records
scripts/session_render.py
Advisor knowledge
- Source texts
- Source extraction
scripts/corpusbuild/ingest.py - Text tagging
scripts/corpusbuild/clean.py - Corpus chunking
scripts/corpusbuild/chunk.py - Corpus publishing
scripts/corpusbuild/pipeline.py - Advisor corpus
scripts/corpusbuild/paths.py - Passage retrieval
scripts/engine/retrieval.py - Retrieval engines
scripts/engine/__init__.py - Quote verification
scripts/engine/fidelity.py
Decision tools
- Decision maps
scripts/decision_map.py - Premortems
scripts/premortem.py - Argument analysis
scripts/principis.py - Decision mirror
scripts/mirror.py
Federated board
- Federation coordinator
scripts/federation/coordinator.py - Role-task queue
scripts/federation/queue.py - Task executor
scripts/federation/executor.py - Candidate judge
scripts/federation/judge.py
Other components
- Decision-maker
- Host agent
Connections 22
- Decision-maker → Host agent: asks question
README.md - Host agent → MCP tools: calls tools
README.md - MCP tools → Passage retrieval: retrieves passages
scripts/mcp_server.py - MCP tools → Quote verification: checks quotes
scripts/mcp_server.py - MCP tools → Decision maps: offers calculation
scripts/mcp_server.py - MCP tools → Federation coordinator: starts federation
scripts/mcp_server.py - Host agent → Advisor lenses: uses lenses
README.md - Source texts → Source extraction: extracts text
- Corpus publishing → Source extraction: calls extraction
scripts/corpusbuild/pipeline.py - Corpus publishing → Text tagging: tags records
scripts/corpusbuild/pipeline.py - Corpus publishing → Corpus chunking: chunks records
scripts/corpusbuild/pipeline.py - Corpus publishing → Advisor corpus: publishes corpus
scripts/corpusbuild/pipeline.py - Passage retrieval → Advisor corpus: reads passages
scripts/engine/retrieval.py - Passage retrieval → Retrieval engines: resolves backend
scripts/engine/retrieval.py - Quote verification → Advisor corpus: checks exact text
scripts/engine/fidelity.py - Federation coordinator → Role-task queue: enqueues tasks
scripts/federation/coordinator.py - Federation coordinator → Candidate judge: scores candidates
scripts/federation/coordinator.py - Task executor → Role-task queue: claims tasks
- Host agent → Session records: records session
README.md - Host agent → Premortems: requests premortem
README.md - Host agent → Argument analysis: requests analysis
README.md - Host agent → Decision mirror: requests mirror
README.md