7274d399ce
- 3 advisors (Pragmatist, Visionary, Skeptic) + 1 Referee subagent - Default: parallel + synthesis flow - Prompt templates in references/prompts.md - Model tier selection based on topic complexity - Added TODO tasks for personality depth and skill name revisit
3.1 KiB
name, description
| name | description |
|---|---|
| council | Convene a council of AI advisor agents with distinct perspectives to deliberate on a topic, then synthesize their views into a verdict. Use when: (1) user asks for multi-perspective analysis, (2) wants to brainstorm with diverse viewpoints, (3) requests a council or advisors opinion, (4) needs a balanced decision on a complex question. Supports parallel (default), sequential, and debate flows. NOT for: simple factual lookups, single-perspective tasks, or quick one-liner answers. |
Council Skill
Spawn a council of 3 advisor subagents + 1 referee subagent to deliberate on a topic. Each advisor has a distinct personality/lens. The referee synthesizes their output into a final verdict with collapsed advisor perspectives.
Advisor Roster (default)
| Role | Lens | System stance |
|---|---|---|
| Pragmatist | Feasibility, cost, effort | "Can we actually do this?" |
| Visionary | Long-term potential, innovation | "What if we went bigger?" |
| Skeptic | Risk, failure modes, edge cases | "What could go wrong?" |
The referee is a separate agent: balanced, fair, synthesis-oriented.
Flows
Three deliberation flows are available. Default is parallel.
1. Parallel + Synthesis (default)
- Spawn all 3 advisors simultaneously via
sessions_spawn(mode=run). - Each advisor receives the same topic prompt with their personality instructions.
- Wait for all 3 to complete (push-based — they announce when done).
- Spawn the referee with all 3 advisor outputs as context.
- Referee produces the final verdict.
2. Sequential Rounds
- Spawn advisors one at a time, each seeing prior advisor outputs.
- After all advisors, spawn referee with full thread.
- Optionally run a rebuttal round (advisors respond to each other).
3. Debate
- Spawn advisors in parallel for initial takes.
- Share outputs across advisors for rebuttals (1-2 rounds).
- Referee moderates and calls convergence.
Model Selection
Pick model tier based on topic complexity:
- Light topics (casual brainstorm, simple pros/cons): use default model for advisors and referee.
- Medium topics (architecture decisions, strategy): use default model for advisors, stronger model for referee.
- Heavy topics (critical decisions, deep analysis): use stronger model for all agents.
The caller (main agent) determines tier before spawning.
Prompt Templates
See references/prompts.md for full advisor and referee prompt templates with placeholders.
Implementation
Read scripts/council.sh for the orchestration logic.
For programmatic invocation, the main agent can also call sessions_spawn directly
following the patterns above.
Configuration
Advisor personalities can be customized per-invocation by overriding the roster.
Default roster and prompt templates live in references/prompts.md.
TODO (revisit later)
- Revisit subagent personality depth — richer backstories, communication styles
- Revisit skill name — "council" works for now