Deep Deliberation
Leading words: option tree, evidence tournament, reversibility,
adversarial review, premortem, uncertainty, checkpoint, ground truth.
Deep Deliberation frames a consequential decision, compares viable alternatives,
tests them against evidence, and adjudicates unresolved risks. The pipeline
produces a decision record, not implementation.
Operating contract
- Do not edit files, implement code, or create formal plan documents while the
pipeline is active.
- Ground claims in repository evidence and current external sources when the
decision depends on them.
- Keep at least two viable approaches through Stage 2 to resist early anchoring.
- Preserve material disagreements; never silently average them away.
- Treat isolated delegates as separate contexts, not independent authorities.
- Never invent missing delegate findings or unsupported evidence.
- Stop after every checkpoint. Continue only after the user explicitly responds.
- The user may revise, restart, or end the pipeline at any checkpoint.
- A meta question does not advance the state; answer it, repeat the state block,
and remain at the current checkpoint.
Runtime state
Start every pipeline response with this block and update it mechanically:
DELIBERATION_STATE
stage: 1 | 2 | 3
checkpoint: none | 1 | 2 | 3
shortlist: unset | A,B
delegate_results: 0/N
next_action: one action only
If the state is missing after a context change, reconstruct it from the latest
completed template and ask the user to confirm before advancing.
Pipeline
- Stage 1 — Frame and shortlist: define the decision, generate 3–5
approaches, and shortlist the strongest two.
- Checkpoint 1: user approves the framing and shortlist.
- Stage 2 — Evidence tournament: 3–5 focused reviewers compare both
shortlisted approaches using a normalized evidence contract.
- Checkpoint 2: user reviews findings and unresolved disputes.
- Stage 3 — Adjudication: targeted evidence review and premortem produce the
final recommendation.
- Checkpoint 3: user approves, revises, or rejects the recommendation.
No implementation follows automatically. Wait for an explicit post-pipeline
request.
Stage 1 — Frame and shortlist
Stage 1 is performed by the orchestrator without delegates.
Entry gate
If the decision is materially ambiguous, ask focused clarification before
starting Stage 1. If the task primarily audits something already built or
written, recommend dissect instead.
Procedure
- Inspect relevant code, schemas, documentation, constraints, and prior
decisions.
- State the decision, desired outcome, constraints, non-goals, assumptions,
evidence gaps, decision horizon, reversibility, and cost of delay.
- Declare evaluation criteria before evaluating options. Use
must,
important, and preference; use numeric weights only when defensible.
- Generate 3–5 meaningfully different approaches. For each, state its
mechanism, expected benefit, main downside, critical assumptions, supporting
evidence, reversibility, rough effort, and failure condition.
- Remove clearly dominated options with an explicit reason.
- Shortlist the strongest option and strongest challenger. Relabel them
Option A and Option B for the remaining stages. Do not make the final
recommendation yet.
Read references/output_templates.md, emit the
complete Stage 1 template, set checkpoint: 1, and stop.
Checkpoint 1 choices:
- Approve the framing and shortlist.
- Replace, merge, or revise an option.
- Change criteria or constraints.
- End the pipeline because the decision is now obvious.
Stage 2 — Evidence tournament
Stage 2 compares both shortlisted approaches. It does not defend a winner chosen
in Stage 1.
Reviewer missions
Use these four default missions:
- Feasibility and integration
- Failure, security, and edge cases
- Operations, migration, and cost
- Challenger advocate
Add one domain specialist only when the decision clearly requires expertise not
covered above. Omit a default mission only when it is demonstrably irrelevant;
never run fewer than three reviews without user approval.
Procedure
- Identify specific repository files and authoritative external sources needed
to evaluate the decision.
- Read references/subagent_prompt.md.
- Launch one isolated, read-only delegate per mission using the host's supported
mechanism. Use the host's default model unless the user requested another.
- Launch delegates together when parallel dispatch is available. Launch and
synthesis are separate assistant steps.
- After results return, normalize and cluster them into evidence-backed
blockers, fixable risks, minor concerns, unverified claims, disagreements,
and evidence favoring the challenger.
- If evidence invalidates both options, return to Stage 1 after user approval.
Each delegate returns no more than three findings. Every finding must contain:
claim:
evidence:
source:
impact: blocker | fixable | minor | unverified
confidence: high | medium | low
affected_option: A | B | both
falsifier:
A blocker without evidence is unverified, not fatal.
Read references/output_templates.md, emit the
complete Stage 2 template, set checkpoint: 2, and stop.
Checkpoint 2 choices:
- Proceed to adjudication.
- Revise an option and repeat Stage 2.
- Reopen Stage 1 with changed criteria or alternatives.
- End the pipeline.
Stage 3 — Adjudication
Stage 3 resolves uncertainty instead of repeating Stage 2 with new personas.
Run these two read-only review missions:
- Evidence adjudicator: verify disputed and high-impact claims; distinguish
corroboration from repeated assertion.
- Premortem challenger: assume the leading option failed six months after
launch, identify the most plausible causes, and present the strongest
remaining case for the runner-up.
Add a third domain adjudicator only when a Stage 2 dispute requires specialized
resolution.
The orchestrator then produces:
- Recommendation and rationale
- Comparison against the declared criteria
- Evidence that determined the decision
- Verified and unverified assumptions
- Material disagreements
- Reversibility and rollback cost
- Premortem risks and mitigations
- Conditions that would change the recommendation
- Ranked alternatives
- Cheapest experiment or spike that could reduce remaining uncertainty
- One next action appropriate to the session's current capabilities
Read references/output_templates.md, emit the
complete Final template, set checkpoint: 3, and stop.
Checkpoint 3 choices:
- Approve the recommendation.
- Request revision.
- Select an alternative.
- Request planning or implementation as a separate next action.
Delegate failure protocol
- Retry one transient delegate failure.
- Report unavailable missions explicitly.
- If fewer than three Stage 2 reviews or fewer than two Stage 3 reviews return,
ask whether to retry or continue in labelled degraded mode.
- If delegation is unavailable, state
DELEGATED_REVIEW_UNAVAILABLE and ask
before substituting isolated orchestrator passes.
- Never synthesize findings that were not returned.
Completion check
Before declaring the pipeline complete, verify:
- At least two viable approaches received adversarial comparison.
- High-impact claims carry evidence or are labelled unverified.
- Reversibility and residual uncertainty are explicit.
- Material disagreements remain visible.
- The recommendation states what evidence would overturn it.
- No implementation occurred before explicit post-checkpoint approval.
References
- references/subagent_prompt.md — portable
delegate dispatch, reviewer prompt, evidence contract, and failure handling.
- references/output_templates.md — exact
Stage 1, Stage 2, and Final response structures.
1---2name: deep-deliberation3description: Runs a checkpoint-gated decision process for consequential, forward-looking design choices. Use only when the user explicitly invokes deep-deliberation to compare approaches, challenge assumptions, and reach an evidence-grounded recommendation before implementation. Use dissect instead to audit an existing system or written plan.4---56# Deep Deliberation78> **Leading words:** option tree, evidence tournament, reversibility,9> adversarial review, premortem, uncertainty, checkpoint, ground truth.1011Deep Deliberation frames a consequential decision, compares viable alternatives,12tests them against evidence, and adjudicates unresolved risks. The pipeline13produces a decision record, not implementation.1415## Operating contract1617- Do not edit files, implement code, or create formal plan documents while the18 pipeline is active.19- Ground claims in repository evidence and current external sources when the20 decision depends on them.21- Keep at least two viable approaches through Stage 2 to resist early anchoring.22- Preserve material disagreements; never silently average them away.23- Treat isolated delegates as separate contexts, not independent authorities.24- Never invent missing delegate findings or unsupported evidence.25- Stop after every checkpoint. Continue only after the user explicitly responds.26- The user may revise, restart, or end the pipeline at any checkpoint.27- A meta question does not advance the state; answer it, repeat the state block,28 and remain at the current checkpoint.2930## Runtime state3132Start every pipeline response with this block and update it mechanically:3334```text35DELIBERATION_STATE36stage: 1 | 2 | 337checkpoint: none | 1 | 2 | 338shortlist: unset | A,B39delegate_results: 0/N40next_action: one action only41```4243If the state is missing after a context change, reconstruct it from the latest44completed template and ask the user to confirm before advancing.4546## Pipeline47481. **Stage 1 — Frame and shortlist:** define the decision, generate 3–549 approaches, and shortlist the strongest two.502. **Checkpoint 1:** user approves the framing and shortlist.513. **Stage 2 — Evidence tournament:** 3–5 focused reviewers compare both52 shortlisted approaches using a normalized evidence contract.534. **Checkpoint 2:** user reviews findings and unresolved disputes.545. **Stage 3 — Adjudication:** targeted evidence review and premortem produce the55 final recommendation.566. **Checkpoint 3:** user approves, revises, or rejects the recommendation.5758No implementation follows automatically. Wait for an explicit post-pipeline59request.6061## Stage 1 — Frame and shortlist6263Stage 1 is performed by the orchestrator without delegates.6465### Entry gate6667If the decision is materially ambiguous, ask focused clarification before68starting Stage 1. If the task primarily audits something already built or69written, recommend `dissect` instead.7071### Procedure72731. Inspect relevant code, schemas, documentation, constraints, and prior74 decisions.752. State the decision, desired outcome, constraints, non-goals, assumptions,76 evidence gaps, decision horizon, reversibility, and cost of delay.773. Declare evaluation criteria before evaluating options. Use `must`,78 `important`, and `preference`; use numeric weights only when defensible.794. Generate 3–5 meaningfully different approaches. For each, state its80 mechanism, expected benefit, main downside, critical assumptions, supporting81 evidence, reversibility, rough effort, and failure condition.825. Remove clearly dominated options with an explicit reason.836. Shortlist the strongest option and strongest challenger. Relabel them84 `Option A` and `Option B` for the remaining stages. Do not make the final85 recommendation yet.8687Read [references/output_templates.md](references/output_templates.md), emit the88complete Stage 1 template, set `checkpoint: 1`, and stop.8990Checkpoint 1 choices:9192- Approve the framing and shortlist.93- Replace, merge, or revise an option.94- Change criteria or constraints.95- End the pipeline because the decision is now obvious.9697## Stage 2 — Evidence tournament9899Stage 2 compares both shortlisted approaches. It does not defend a winner chosen100in Stage 1.101102### Reviewer missions103104Use these four default missions:1051061. **Feasibility and integration**1072. **Failure, security, and edge cases**1083. **Operations, migration, and cost**1094. **Challenger advocate**110111Add one domain specialist only when the decision clearly requires expertise not112covered above. Omit a default mission only when it is demonstrably irrelevant;113never run fewer than three reviews without user approval.114115### Procedure1161171. Identify specific repository files and authoritative external sources needed118 to evaluate the decision.1192. Read [references/subagent_prompt.md](references/subagent_prompt.md).1203. Launch one isolated, read-only delegate per mission using the host's supported121 mechanism. Use the host's default model unless the user requested another.1224. Launch delegates together when parallel dispatch is available. Launch and123 synthesis are separate assistant steps.1245. After results return, normalize and cluster them into evidence-backed125 blockers, fixable risks, minor concerns, unverified claims, disagreements,126 and evidence favoring the challenger.1276. If evidence invalidates both options, return to Stage 1 after user approval.128129Each delegate returns no more than three findings. Every finding must contain:130131```text132claim:133evidence:134source:135impact: blocker | fixable | minor | unverified136confidence: high | medium | low137affected_option: A | B | both138falsifier:139```140141A blocker without evidence is `unverified`, not fatal.142143Read [references/output_templates.md](references/output_templates.md), emit the144complete Stage 2 template, set `checkpoint: 2`, and stop.145146Checkpoint 2 choices:147148- Proceed to adjudication.149- Revise an option and repeat Stage 2.150- Reopen Stage 1 with changed criteria or alternatives.151- End the pipeline.152153## Stage 3 — Adjudication154155Stage 3 resolves uncertainty instead of repeating Stage 2 with new personas.156157Run these two read-only review missions:1581591. **Evidence adjudicator:** verify disputed and high-impact claims; distinguish160 corroboration from repeated assertion.1612. **Premortem challenger:** assume the leading option failed six months after162 launch, identify the most plausible causes, and present the strongest163 remaining case for the runner-up.164165Add a third domain adjudicator only when a Stage 2 dispute requires specialized166resolution.167168The orchestrator then produces:169170- Recommendation and rationale171- Comparison against the declared criteria172- Evidence that determined the decision173- Verified and unverified assumptions174- Material disagreements175- Reversibility and rollback cost176- Premortem risks and mitigations177- Conditions that would change the recommendation178- Ranked alternatives179- Cheapest experiment or spike that could reduce remaining uncertainty180- One next action appropriate to the session's current capabilities181182Read [references/output_templates.md](references/output_templates.md), emit the183complete Final template, set `checkpoint: 3`, and stop.184185Checkpoint 3 choices:186187- Approve the recommendation.188- Request revision.189- Select an alternative.190- Request planning or implementation as a separate next action.191192## Delegate failure protocol1931941. Retry one transient delegate failure.1952. Report unavailable missions explicitly.1963. If fewer than three Stage 2 reviews or fewer than two Stage 3 reviews return,197 ask whether to retry or continue in labelled degraded mode.1984. If delegation is unavailable, state `DELEGATED_REVIEW_UNAVAILABLE` and ask199 before substituting isolated orchestrator passes.2005. Never synthesize findings that were not returned.201202## Completion check203204Before declaring the pipeline complete, verify:205206- At least two viable approaches received adversarial comparison.207- High-impact claims carry evidence or are labelled unverified.208- Reversibility and residual uncertainty are explicit.209- Material disagreements remain visible.210- The recommendation states what evidence would overturn it.211- No implementation occurred before explicit post-checkpoint approval.212213## References214215- [references/subagent_prompt.md](references/subagent_prompt.md) — portable216 delegate dispatch, reviewer prompt, evidence contract, and failure handling.217- [references/output_templates.md](references/output_templates.md) — exact218 Stage 1, Stage 2, and Final response structures.