decision-critic
Decision Critic
When this skill activates, you become a structured decision critic. Your role is to systematically stress-test reasoning before commitment, surfacing hidden assumptions, verifying claims, and generating adversarial perspectives.
Triggers
Activate when the user:
Validate my thinking on...Poke holes in this decisionCriticize this approachStress-test this tradeoff- Presents a decision rationale and asks for criticism
Process
DECOMPOSITION (1-2) Extract claims, assumptions, constraints, judgments
| Assign stable IDs (C1, A1, K1, J1)
v
VERIFICATION (3-4) Generate verification questions
| Answer independently (factored verification)
v Mark: VERIFIED | FAILED | UNCERTAIN
CHALLENGE (5-6) Contrarian perspective + alternative framing
|
v
SYNTHESIS (7) Verdict: STAND | REVISE | ESCALATE
Scripts
decision-critic.py
python3 .claude/skills/decision-critic/scripts/decision-critic.py \
--step-number <1-7> \
--total-steps 7 \
--decision "<decision text>" \
--context "<constraints and background>" \
--thoughts "<your accumulated analysis, IDs, and status from all previous steps>"
Exit Codes:
- 0: Successful completion
- 1: Invalid arguments or missing required parameters
- 2: Analysis failed or incomplete
| Argument | Required | Description |
|---|---|---|
--step-number |
Yes | Current step (1-7) |
--total-steps |
Yes | Always 7 |
--decision |
Step 1 | The decision statement being criticized |
--context |
Step 1 | Constraints, background, system context |
--thoughts |
Yes | Your analysis including all IDs and status from prior steps |
When to Use
Use this skill when:
- Making a consequential decision that is hard to reverse
- Evaluating a plan, ADR, or design before commitment
- You want structured adversarial feedback, not just a second opinion
Use independent-thinker agent instead when:
- You need strategic challenge on direction (whether, not how)
- The question is about project scope or priorities, not technical reasoning
Anti-Patterns
| Avoid | Why | Instead |
|---|---|---|
| Running critique after commitment | Too late to change course | Critique before finalizing decisions |
| Accepting STAND verdict without reading analysis | Misses nuanced findings | Review all UNCERTAIN and FAILED items |
| Skipping the inversion step | Misses failure modes that forward reasoning overlooks | Always run Steps 5-6 |
| Using for trivial decisions | Wastes time on low-stakes choices | Reserve for consequential, hard-to-reverse decisions |
Verification
After execution:
- All claims have status: VERIFIED, FAILED, or UNCERTAIN
- Contrarian perspective generated (Step 5)
- Final verdict is one of: STAND, REVISE, ESCALATE
- Inversion analysis covers at least 3 failure modes
Academic Grounding
This workflow synthesizes three empirically-validated techniques:
- Chain-of-Verification (Dhuliawala et al., 2023) - Factored verification prevents confirmation bias
- Self-Consistency (Wang et al., 2023) - Multiple reasoning paths reveal disagreement
- Multi-Expert Prompting (Wang et al., 2024) - Diverse perspectives catch blind spots
Inversion Thinking Protocol
Before finalizing any decision, apply inversion to identify failure modes:
Step 1: State the Goal
Clearly articulate what success looks like.
Example: "Make the agent system reliable and maintainable"
Step 2: Invert the Goal
Flip it to identify failure modes: "How would we ensure the agent system fails?"
Step 3: List Failure Scenarios
Brainstorm specific ways to achieve failure:
- Remove all validation gates
- Allow circular agent delegation
- Make handoffs implicit
- Hide dependencies
- Skip documentation
- No testing strategy
Step 4: Reverse to Success Criteria
Convert each failure mode into a success criterion:
- Failure: "No validation gates" → Success: "Automated validation at every phase"
- Failure: "Circular delegation" → Success: "Clear hierarchy preventing loops"
- Failure: "Implicit handoffs" → Success: "Explicit handoff protocol"
Step 5: Validate Decision Against Inverted Criteria
Check if the decision being reviewed addresses each failure mode.
Output Template:
## Inversion Analysis
### Goal
[What success looks like]
### Inverted Goal (Failure)
[How to ensure failure]
### Failure Modes
1. [Failure mode 1]
2. [Failure mode 2]
3. [Failure mode 3]
### Success Criteria (Reversed)
1. [Success criterion 1 - addresses failure mode 1]
2. [Success criterion 2 - addresses failure mode 2]
3. [Success criterion 3 - addresses failure mode 3]
### Decision Validation
- [ ] Addresses failure mode 1: [Evidence]
- [ ] Addresses failure mode 2: [Evidence]
- [ ] Addresses failure mode 3: [Evidence]
Application: Use inversion thinking as final check before approving plans or ADRs.