deliberation
Skill146 starsChanged 7 months agoMITView on GitHub
Use BEFORE brainstorming when facing a complex architectural, technology, or design decision where the options are not yet well-defined or the problem itself may need reframing. Assembles named stakeholder perspectives that each speak once without debate, then surfaces where they converge and where real tension remains — without forcing a premature choice. Triggers on: "should we use X or Y", "not sure which approach", "evaluate these options", "what are the trade-offs between", "help me think through this decision", "architecture decision", "technology choice". Routed by using-superpowers before brainstorming when the decision space is unclear.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- LARi-UQAC/ResearchToolstheir own version, first seen Nov 5, 2026
- antonbabenko/deliberationtheir own version, first seen Oct 13, 2026
- 2389-research/deliberationtheir own version, first seen Jul 6, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- antonbabenko/deliberation★ 181same name
- LARi-UQAC/ResearchTools★ 14same name
- 2389-research/deliberation★ 8same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- brainstormingSkill
- claude-md-creatorSkill
- context-managementSkill
- dependency-managementSkill
- dispatching-parallel-agentsSkill
- error-recoverySkill
- executing-plansSkill
- finishing-a-development-branchSkill
- frontend-designSkill
- performance-investigationSkill
- premise-checkSkill
- receiving-code-reviewSkill
- refactoringSkill
- requesting-code-reviewSkill
- self-consistency-reasonerSkill
- subagent-driven-developmentSkill
- systematic-debuggingSkill
- test-driven-developmentSkill
- token-efficiencySkill
- using-git-worktreesSkill
- using-superpowersSkill
- verification-before-completionSkill
- writing-plansSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 7 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 61
Do not rank or evaluate perspectives as they speak
- Distinctive: line 62
Do not let one perspective address another's concerns
- Distinctive: line 66
After all perspectives have spoken, identify:
- Distinctive: line 109
Do not force a conclusion.
- Distinctive: line 110
Do not let any perspective "win" the deliberation.
- Distinctive: line 111
If the deliberation reveals a reframe, do not proceed to brainstorming until the reframe is acknowledged by the user.
- Distinctive: line 112
Keep each perspective to 3–5 sentences.
- Very specific: line 113
If fewer than 3 genuine perspectives exist for this decision, the decision is probably already well-framed.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Deliberation
Surface genuine tension in a decision before committing to a direction.
When to use
Some decisions get worse when you're forced to choose too early. Use deliberation when:
- The options themselves are not yet well-defined
- The problem may be framed incorrectly (the real question hasn't been asked)
- Multiple legitimate constraints pull in different directions
- Brainstorming feels premature — there's no clear "right shape" for the solution yet
Do not use for: decisions that are already well-framed with clear options. Those go directly to brainstorming. Deliberation is for when you're not yet ready for options.
Procedure
1. Name the decision
State the decision being deliberated in one sentence. Be precise — a vague decision produces vague perspectives.
Example: "Should we migrate the authentication layer from JWT to session cookies?"
2. Identify 3–5 genuine stakeholder perspectives
Choose perspectives that have real, distinct stakes in the decision. Each perspective represents a legitimate set of constraints or values — not a person, but a role with a coherent viewpoint.
Good perspectives for technical decisions:
- The Security Engineer — attack surface, credential management, audit trail
- The Developer Experience Advocate — implementation complexity, debugging, onboarding
- The Ops/Infrastructure Engineer — deployment, scaling, observability, failure modes
- The Maintainability Advocate — long-term code health, testability, cognitive load
- The Performance Engineer — latency, throughput, caching, resource cost
- The User/Product Perspective — visible user impact, reliability, behaviour changes
Choose only perspectives with genuine stakes in this specific decision. Three well-chosen perspectives beat five generic ones.
3. Let each perspective speak once
For each perspective in turn:
- State what this perspective most values in the context of this decision
- Identify the specific concern or constraint it sees
- Name what it would lose in each direction being considered
Ground rules:
- Each perspective speaks once only — no rebuttal, no scoring, no debate
- Do not rank or evaluate perspectives as they speak
- Do not let one perspective address another's concerns
4. Listen for convergence and tension
After all perspectives have spoken, identify:
Convergence — where all (or most) perspectives agree, despite coming from different values. These points are load-bearing: a decision that violates them will cause problems regardless of which option is chosen.
Live tension — where perspectives genuinely disagree and no option fully satisfies all of them. These are the real trade-offs. Do not paper over them — surface them explicitly.
Reframes — where the act of hearing all perspectives reveals that the original decision was mis-stated, and the real question is something else entirely.
5. Output
## Deliberation: [Decision statement]
### Perspectives
**[Perspective name]**
Values: [What this perspective cares about most]
Concern: [The specific risk or constraint it sees]
What it loses going left: [Downside of option A]
What it loses going right: [Downside of option B]
[Repeat for each perspective]
### Convergence
[Points where perspectives agree regardless of their different values]
### Live Tension
[Where perspectives genuinely disagree — the real trade-offs that cannot be avoided]
### Reframe (if applicable)
[If the deliberation revealed that the original question was wrong, state the better question here]
### Next step
[One of:
- "proceed to brainstorming with this framing"
- "return to user — the decision needs more information before proceeding"
- "the reframe changes the scope — revisit premise-check before continuing"
*(Loop guard: if premise-check has already been invoked for this task, skip it and proceed directly to brainstorming. Never cycle between deliberation and premise-check more than once.)*
]Rules
- Do not force a conclusion. The output is clarity about the decision space, not a recommendation.
- Do not let any perspective "win" the deliberation. All tensions remain visible.
- If the deliberation reveals a reframe, do not proceed to brainstorming until the reframe is acknowledged by the user.
- Keep each perspective to 3–5 sentences. Deliberation is not brainstorming — it is structured listening.
- If fewer than 3 genuine perspectives exist for this decision, the decision is probably already well-framed. Use
brainstorminginstead.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

