council
affaan-m/everything-claude-code
Convene four independent voices—Architect, Skeptic, Pragmatist, Critic—to surface structured disagreement on ambiguous decisions.
What is council?
Council is a decision-making skill that launches three subagent perspectives alongside your own to challenge assumptions and surface tradeoffs before committing to a path. Use it when multiple credible options exist and you need explicit dissent to avoid anchoring bias.
- Extracts and clarifies the real decision question before convening voices
- Gathers only necessary context to avoid information overload
- Launches three independent subagents in parallel with strict roles to prevent anchoring
- Synthesizes positions with bias guardrails that preserve dissent and flag consensus shifts
- Produces a compact, scannable verdict showing alignment and strongest disagreement
- Integrates with knowledge-ops and session memory to persist only material decision changes
How to install council
npx skills add https://github.com/affaan-m/everything-claude-code --skill councilHow to use council
- 1.Identify a decision with multiple credible paths and no obvious winner
- 2.Reduce the decision to one explicit question: what are we deciding, what constraints matter, what counts as success?
- 3.Gather only the compact context needed (code snippets, metrics, constraints) if codebase-specific; skip for strategic decisions
- 4.Form your own Architect position first with three strongest reasons and main risk before reading other voices
- 5.Launch the three subagents (Skeptic, Pragmatist, Critic) in parallel, each receiving only the question and relevant context
- 6.Synthesize the four positions using the bias guardrails: do not dismiss external views without explaining why, flag if an external voice changed your recommendation, preserve strongest dissent
- 7.Present a compact verdict showing consensus, strongest disagreement, premise check, and final recommendation
- 8.Persist the decision only if it materially changes something real, using knowledge-ops or session memory as appropriate
Use cases
- Deciding monorepo vs polyrepo architecture when both are technically viable
- Choosing between shipping now with polish deferred vs holding for completeness
- Evaluating feature flag rollout vs full deployment when risk/speed tradeoffs are unclear
- Assessing scope reduction vs strategic breadth when constraints are ambiguous
- Making go/no-go calls on major refactors or platform migrations with competing valid paths
- Engineering leads making architectural or shipping decisions under uncertainty
- Teams evaluating competing technical strategies with real tradeoffs
- Decision-makers who want to surface and challenge their own assumptions
- Anyone needing structured dissent before committing to an ambiguous path
council FAQ
Use council when a decision has multiple credible paths, you need explicit tradeoff surfacing, conversational anchoring is a real risk, or the user asks for second opinions and dissent. Do not use it for code review, implementation planning, architecture design, or straight factual questions.
Feeding subagents the entire conversation history anchors them to your framing and reasoning. Launching them fresh with only the decision question and relevant context preserves the anti-anchoring mechanism that makes council valuable.
Treat that as a real signal. The synthesis rules require you to flag when two or more external voices align against your initial position and to explain why you are rejecting them, not to dismiss the disagreement.
No. Only persist a decision when it materially changes something real—a GitHub issue, Linear ticket, session memory, or durable knowledge base. Do not write ad-hoc notes for every council call.
Yes, but keep the new question focused, include the previous verdict only if necessary, and keep the Skeptic clean to preserve anti-anchoring value.
Full instructions (SKILL.md)
Source of truth, from affaan-m/everything-claude-code.
name: council description: Convene a four-voice council for ambiguous decisions, tradeoffs, and go/no-go calls. Use when multiple valid paths exist and you need structured disagreement before choosing. metadata: origin: ECC
Council
Convene four advisors for ambiguous decisions:
- the in-context Claude voice
- a Skeptic subagent
- a Pragmatist subagent
- a Critic subagent
This is for decision-making under ambiguity, not code review, implementation planning, or architecture design.
When to Use
Use council when:
- a decision has multiple credible paths and no obvious winner
- you need explicit tradeoff surfacing
- the user asks for second opinions, dissent, or multiple perspectives
- conversational anchoring is a real risk
- a go / no-go call would benefit from adversarial challenge
Examples:
- monorepo vs polyrepo
- ship now vs hold for polish
- feature flag vs full rollout
- simplify scope vs keep strategic breadth
When NOT to Use
| Instead of council | Use |
|---|---|
| Verifying whether output is correct | santa-method |
| Breaking a feature into implementation steps | planner |
| Designing system architecture | architect |
| Reviewing code for bugs or security | code-reviewer or santa-method |
| Straight factual questions | just answer directly |
| Obvious execution tasks | just do the task |
Roles
| Voice | Lens |
|---|---|
| Architect | correctness, maintainability, long-term implications |
| Skeptic | premise challenge, simplification, assumption breaking |
| Pragmatist | shipping speed, user impact, operational reality |
| Critic | edge cases, downside risk, failure modes |
The three external voices should be launched as fresh subagents with only the question and relevant context, not the full ongoing conversation. That is the anti-anchoring mechanism.
Workflow
1. Extract the real question
Reduce the decision to one explicit prompt:
- what are we deciding?
- what constraints matter?
- what counts as success?
If the question is vague, ask one clarifying question before convening the council.
2. Gather only the necessary context
If the decision is codebase-specific:
- collect the relevant files, snippets, issue text, or metrics
- keep it compact
- include only the context needed to make the decision
If the decision is strategic/general:
- skip repo snippets unless they materially change the answer
3. Form the Architect position first
Before reading other voices, write down:
- your initial position
- the three strongest reasons for it
- the main risk in your preferred path
Do this first so the synthesis does not simply mirror the external voices.
4. Launch three independent voices in parallel
Each subagent gets:
- the decision question
- compact context if needed
- a strict role
- no unnecessary conversation history
Prompt shape:
You are the [ROLE] on a four-voice decision council.
Question:
[decision question]
Context:
[only the relevant snippets or constraints]
Respond with:
1. Position — 1-2 sentences
2. Reasoning — 3 concise bullets
3. Risk — biggest risk in your recommendation
4. Surprise — one thing the other voices may miss
Be direct. No hedging. Keep it under 300 words.
Role emphasis:
- Skeptic: challenge framing, question assumptions, propose the simplest credible alternative
- Pragmatist: optimize for speed, simplicity, and real-world execution
- Critic: surface downside risk, edge cases, and reasons the plan could fail
5. Synthesize with bias guardrails
You are both a participant and the synthesizer, so use these rules:
- do not dismiss an external view without explaining why
- if an external voice changed your recommendation, say so explicitly
- always include the strongest dissent, even if you reject it
- if two voices align against your initial position, treat that as a real signal
- keep the raw positions visible before the verdict
6. Present a compact verdict
Use this output shape:
## Council: [short decision title]
**Architect:** [1-2 sentence position]
[1 line on why]
**Skeptic:** [1-2 sentence position]
[1 line on why]
**Pragmatist:** [1-2 sentence position]
[1 line on why]
**Critic:** [1-2 sentence position]
[1 line on why]
### Verdict
- **Consensus:** [where they align]
- **Strongest dissent:** [most important disagreement]
- **Premise check:** [did the Skeptic challenge the question itself?]
- **Recommendation:** [the synthesized path]
Keep it scannable on a phone screen.
Persistence Rule
Do not write ad-hoc notes to ~/.claude/notes or other shadow paths from this skill.
If the council materially changes the recommendation:
- use
knowledge-opsto store the lesson in the right durable location - or use
/save-sessionif the outcome belongs in session memory - or update the relevant GitHub / Linear issue directly if the decision changes active execution truth
Only persist a decision when it changes something real.
Multi-Round Follow-up
Default is one round.
If the user wants another round:
- keep the new question focused
- include the previous verdict only if it is necessary
- keep the Skeptic as clean as possible to preserve anti-anchoring value
Anti-Patterns
- using council for code review
- using council when the task is just implementation work
- feeding the subagents the entire conversation transcript
- hiding disagreement in the final verdict
- persisting every decision as a note regardless of importance
Related Skills
santa-method— adversarial verificationknowledge-ops— persist durable decision deltas correctlysearch-first— gather external reference material before the council if neededarchitecture-decision-records— formalize the outcome when the decision becomes long-lived system policy
Example
Question:
Should we ship ECC 2.0 as alpha now, or hold until the control-plane UI is more complete?
Likely council shape:
- Architect pushes for structural integrity and avoiding a confused surface
- Skeptic questions whether the UI is actually the gating factor
- Pragmatist asks what can be shipped now without harming trust
- Critic focuses on support burden, expectation debt, and rollout confusion
The value is not unanimity. The value is making the disagreement legible before choosing.
Related skills
More from affaan-m/everything-claude-code and the wider catalog.

security-review
Security checklist and patterns for authentication, input validation, secrets, and sensitive features.

golang-patterns
Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable applications.

coding-standards
Baseline coding conventions for naming, readability, immutability, and quality across projects.

frontend-patterns
React and Next.js patterns for components, state management, performance, and modern frontend practices.

backend-patterns
REST/GraphQL API design, database optimization, and server-side patterns for Node.js, Express, and Next.js.

golang-testing
Go testing patterns: table-driven tests, subtests, benchmarks, fuzzing, and TDD methodology.