council-of-high-intelligence README

The project's README from github.com/0xNyk/council-of-high-intelligence. As one markdown file: README.md.

Council of High Intelligence

Council of High Intelligence

Structured multi-perspective deliberation for decisions that deserve more than one reasoning path.

Lint Release License

Claude Code · Codex · Gemini CLI · OpenCode

The council assigns a hard question to deliberately different analytical personas, keeps their first positions independent, forces direct disagreement, and returns a verdict that preserves unresolved questions, dissent, kill criteria, and the next concrete action.

Try a council

Claude Code users can install the plugin directly:

/plugin marketplace add 0xNyk/council-of-high-intelligence
/plugin install council@council-of-high-intelligence

Then convene the full council, a faster panel, or a two-member dialectic:

/council Should we open-source our agent framework?
/council --quick Should we add caching here?
/council --duo Should we use microservices or a monolith?

For Codex, Gemini CLI, or OpenCode, clone once and use the matching installer flag:

git clone https://github.com/0xNyk/council-of-high-intelligence.git
cd council-of-high-intelligence

./install.sh --codex-only
./install.sh --gemini-only
./install.sh --opencode-only

Restart the target client after installation. The command remains /council on every supported host.

Use it for the decision boundary

Good council questions have material downside, competing values, incomplete evidence, or an irreversible choice. Write down the decision, constraints, evidence, reversibility, and deadline before adding personas.

Decision field notes

The field notes distinguish facts from inference, assumptions, and unknowns. They also make it harder to use a long deliberation as decoration for a decision already made.

When to use something smaller

Choose a mode

Mode Shape Use it when
Full Independent analysis, cross-examination, final stance, synthesis Stakes are high and competing frames need contact
Quick Restate, rapid analysis, final positions The decision needs breadth but not a full adversarial round
Duo Opening positions, direct response, final statements One polarity defines the decision

Council mode selector

/council --full What is the right pricing model?
/council --quick --triad shipping Should we release today?
/council --duo --members torvalds,ada Is this abstraction worth it?

Named triads select three relevant lenses without assembling the whole council:

/council --triad strategy Where is our defensible advantage?
/council --triad risk What could make this launch irreversible?
/council --triad ai-product Which capability belongs in the product?

Available domains include architecture, strategy, ethics, debugging, risk, shipping, product, founder, ai, ai-product, ai-safety, decision, systems, uncertainty, design, economics, and bias. The canonical routing table lives in SKILL.md.

What the protocol protects

The full protocol has a fixed round budget. Members first restate the problem, analyze blind, cross-examine other positions, declare a final stance, and then enter synthesis. Enforcement checks look for premature agreement, repeated claims, missing dissent, and unsupported confidence.

Verdict blueprint

Verdicts lead with what remains unresolved. A recommendation is paired with acceptable compromises, kill criteria, and one concrete next step. When the weighted tally remains split, the result returns that split to the user instead of turning it into prose consensus.

Evidence labels separate:

Track the outcome

A verdict is useful only if it can be checked later. Before acting, record the prediction, owner, review date, and evidence that would change the recommendation. At the checkpoint, mark the result confirmed, revised, reversed, or inconclusive instead of rewriting the original rationale.

Council outcome ledger

The 18 lenses

Members are analytical instruments, not impersonation claims. Each persona has a grounding protocol, a method, known blind spots, and a structured response contract.

Council panel composition

Member Primary lens Useful counterweight
Aristotle Categories and structure Lao Tzu on emergence and excess structure
Socrates Assumption destruction Feynman on reconstruction from first principles
Sun Tzu Terrain and adversarial strategy Aurelius on internal control and moral cost
Ada Lovelace Formal systems and abstraction Machiavelli on incentives and informal power
Marcus Aurelius Resilience and moral clarity Sun Tzu on external competition
Machiavelli Power and incentives Ada on formal consistency
Lao Tzu Non-action and emergence Aristotle on explicit categories
Richard Feynman Explanation and empirical debugging Socrates on the premise itself
Linus Torvalds Shipping and maintainability Meadows on system-level consequences
Miyamoto Musashi Timing and decisive action Torvalds on acting before the ideal moment
Alan Watts Reframing and false problems Torvalds on concrete implementation
Andrej Karpathy Empirical ML behavior Sutskever on frontier risk
Ilya Sutskever Scaling and AI safety Karpathy on observation and iteration
Daniel Kahneman Cognitive bias Feynman on explicit causal reasoning
Donella Meadows Feedback loops and high-impact interventions Torvalds on local fixes
Charlie Munger Inversion and model lattices Aristotle on single-system classification
Nassim Taleb Tail risk and fragility Karpathy on smooth empirical trends
Dieter Rams User clarity and restraint Ada on what can be formalized

The repository stores each member contract under agents/. Custom panels can use --members, named triads, or the classic, exploration-orthogonal, and execution-lean profiles documented in SKILL.md.

Multi-provider routing

The detection script checks which supported providers are available, then the coordinator distributes seats across them. Polarity pairs are separated when possible so a single model family does not play both sides of a disagreement.

Council provider routing

Provider path Detection
Native host subagents Available through the active supported client
OpenAI codex executable
Google gemini executable
Ollama ollama executable
NVIDIA NIM NVIDIA_API_KEY
Cursor cursor-agent executable or configured login

Preview routing without running a council:

/council --dry-route --triad decision Should we accept this acquisition offer?

Use --no-auto-route to keep native-host defaults. Use --models <path> with a copy of configs/provider-model-slots.example.yaml for an explicit seat map. Provider failure is reported before the seat falls back to the native host.

Installation reference

./install.sh                         # Claude Code
./install.sh --codex                 # Claude Code + Codex
./install.sh --codex-only            # Codex only
./install.sh --gemini                # Claude Code + Gemini CLI
./install.sh --gemini-only           # Gemini CLI only
./install.sh --opencode              # Claude Code + OpenCode
./install.sh --opencode-only         # OpenCode only
./install.sh --copy-configs          # Include provider-routing templates
./install.sh --dry-run               # Preview writes

Custom target directories are supported through --claude-dir, --codex-dir, --gemini-dir, and --opencode-dir. Run ./install.sh --help for the current contract.

Verify the checkout

./scripts/council-simulation-checklist.sh
./install.sh --dry-run --codex
./install.sh --dry-run --gemini
./install.sh --dry-run --opencode

The checklist validates persona structure, host-protocol parity, routing configuration, execution checkpoints, verdict fields, and installer behavior. Use the demo session pack to exercise full, quick, and duo modes.

Repository map

SKILL.md                    canonical coordinator protocol
SKILL.codex.md              Codex host mirror
SKILL.gemini.md             Gemini CLI host mirror
SKILL.opencode.md           OpenCode host mirror
agents/                     18 grounded persona contracts
configs/                    provider and model-routing examples
demos/                      sample sessions and verdict template
scripts/                    detection, conversion, and validation tools
assets/                     brand system and README visuals
install.sh                  multi-host installer

Protocol changes start in SKILL.md and must remain behaviorally aligned with each host mirror. See CONTRIBUTING.md for the required checks and review contract. Security reports belong in SECURITY.md, not a public issue.

Council of High Intelligence star history

License

MIT © 2026 0xNyk

council-of-high-intelligence (0xNyk/council-of-high-intelligence)

Searching Database…

这是什么?Council of High Intelligence 通过把一个问题交给 18 个各不相同的分析人格(亚里士多德、苏格拉底、费曼、Linus Torvalds 等),对艰难决策进行结构化的多视角审议:强制各方先独立表态,再交叉质询,最后给出保留未决问题、异议、否决标准和具体下一步行动的最终裁定。
这是一个独立应用,还是加到现有 AI 编程助手上使用的东西?它是一个挂接到现有 AI 智能体命令行工具的技能/插件,而不是独立应用。你把它安装到 Claude Code、Codex、Gemini CLI 或 OpenCode 里,然后在宿主中用相同的斜杠命令触发它。
怎么安装它并运行第一次议会?Claude Code 用户直接安装插件,然后运行 /council、--quick 或 --duo。对于 Codex、Gemini CLI 或 OpenCode,克隆一次仓库,用对应的参数(--claude-dir、--codex-dir、--gemini-dir、--opencode-dir)运行 ./install.sh,然后重启客户端。
它实际支持哪些编程智能体?它支持以 Claude Code、Codex、Gemini CLI 和 OpenCode 作为宿主;此外,如果在你的电脑上检测到相应可执行文件或 API 密钥,还可以把席位路由到 OpenAI、Google、Ollama、NVIDIA NIM 或 Cursor。
什么时候应该跳过召开议会?单纯的事实查询(直接查文档即可)和代价低、可撤销的选择(直接做实验就好)都不必用它;也绝不要用它为已经做出的决定制造支持假象。另外,安装后记得重启客户端,否则命令不会出现。
议会里的 18 个人格都是谁?成员包括亚里士多德、苏格拉底、孙子、Ada Lovelace、马可·奥勒留、马基雅维利、老子、费曼、Linus Torvalds、宫本武藏、Alan Watts、Karpathy、Ilya Sutskever、卡尼曼、Donella Meadows、Charlie Munger、Nassim Taleb 和 Dieter Rams,每个人都搭配一个制衡视角,以促成真正的分歧。
Full、Quick 和 Duo 三种模式有什么区别?Full 模式为高风险决策运行独立分析、交叉质询、最终立场和综合;Quick 模式复述问题并给出快速分析和最终立场,适用于广度比完整对抗回合更重要的场合;Duo 模式是两位成员的辩证对谈,适用于由单一对立面定义的决策。
它会检查裁定后来是否站得住脚吗?在根据建议行动之前,你需要记录预测、负责人、复查日期以及会改变结论的证据;到了检查点,结果会被标记为已确认、已修订、已推翻或无定论,而不是重写原来的推理。
可以不用全部 18 个成员,改用更小的评审组吗?可以。内置的命名三人组会从架构、战略、伦理、调试、风险或 ai-safety 等领域提取三个相关视角;也可以使用 --members 并参照 SKILL.md 中的路由表来构建自定义评审组。
Creator
0xNyk
Size
5.8 MB
Stars
4.7K
Age
7mo
Commits · 90 Days