Spot when a single impression is distorting all your ratings — and get a structured fix.
Coding
Hanlon's Razor
Try itPause before attributing malice — test the mistake explanation first.
What it does
A structured thinking tool that helps you override the gut instinct to assume someone acted with harmful intent. When strong emotion pulls you toward 'they did this on purpose,' the skill walks you through constructing the incompetence-or-miscommunication alternative, assessing its coverage of the evidence, and naming what malice would additionally require. Produces a named prior and override signal so you can update cleanly when evidence arrives.
When to use it
- Colleague's terse email triggering anger and desire to confront
- About to escalate a conflict based on assumed bad faith
- Team interpreting a pattern of failures as a coordinated attack
- Reading a competitor's surprising move as deliberate sabotage
The skill document
Hanlon's Razor
Overview
Before assuming someone hurt you on purpose, construct the version where they made a mistake — and see how much evidence it explains. The razor is a Bayesian prior, not a proof; override it when concrete evidence of malice arrives. Human attribution systematically over-weights intent (fundamental attribution error); most hostile-seeming acts are incompetence, miscommunication, or asymmetric information.
Composes with bayesian-reasoning, abductive-reasoning, occams-razor, critical-thinking.
When to Use
- You feel an emotional pull toward "they did this on purpose"
- You're about to escalate on the assumption of malice
- A pattern of bad outcomes is being framed as a coordinated attack
- A team is in conflict and each side believes the other is acting in bad faith
- An AI model's harmful/biased output or a competitor's surprising AI move is being read as deliberate malice rather than an emergent bug, honest error, or ordinary self-interested competition
Not when: concrete evidence of malicious intent exists; cost of being wrong is catastrophic; power imbalance makes "they probably didn't mean it" an abuse-enabling stance.
Coaching Novices (Adaptive Front Door)
- Engine mode: user has a concrete case → run The Process directly.
- Coach mode: user is unfamiliar → guide step by step.
In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.
- One-line: before believing someone did it on purpose, construct the mistake version — see how much evidence it covers.
- Check fit: concrete malice evidence / catastrophic cost of being wrong → not this lens.
- Elicit the specific incident — what exactly happened?
[WAIT — do not advance until user responds]
- Work through The Process one step at a time with their input.
[WAIT — do not advance until user responds]
- Close: name the clarifying-conversation move + the override signal to watch for.
[WAIT — do not advance until user responds]
The Process
Step 1 — Describe the action and harm (factual, not interpretive)
- What was done:
- Harm to me:
- Gut attribution:
Step 2 — Construct the non-malice explanation
- Bad information they had: / Didn't realize: / Optimizing for: / Under pressure from:
- Coverage: <% of observed behavior this explains>
Step 3 — Name what malice would additionally require
- Info they'd need: / Motivation at your expense: / Harm predictable from their position?
Step 4 — Choose starting posture · Step 5 — Set override signal · Step 6 — Hold prior until evidence changes it
- Prior: · Starting posture: · First move: · Override trigger:
Output Template
# Hanlon's Razor Analysis:
Mistake explanation + coverage % | Malice extra assumptions | Prior | Override signal | First action
→ Method in Action: Hanlon's Submission 1980; Heinlein's 1941 Articulation
→ 2026 lens: AI Incidents — Incompetence & Emergent Error as a Prior Over Malice (2024–2026)
Pack: Common Patterns
| Situation | Default malice | Likely incompetence |
|---|---|---|
| Colleague sends harsh email | "They're undermining me" | Tired, didn't notice tone |
| Manager ignores your work | "They don't value me" | Overloaded, missed the update |
| Customer complains publicly | "Trying to extort us" | Real issue, tried other channels |
| Investor passes after diligence | "Were never serious" | Portfolio rebalancing |
| Co-founder makes unilateral decision | "Cutting me out" | Time pressure, assumed approval |
Applying It Well
- Mistake-prior conversations produce information; malice-prior conversations produce defensiveness — even when malice later turns out true.
- The malice attribution feels viscerally correct in real-time; almost always overconfident in retrospect.
- Scales from individual to institutional: most "broken culture" is coordination failure, not coordinated malice.
→ Primary sources: references/sources.md
Common Rationalizations
[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.
| Fake move | Reality |
|---|---|
| [D] Apply razor then ignore mounting evidence of malice | It's a prior, not a permanent ban on updating. |
| [D] Use razor to avoid hard conversations | It recommends a clarifying conversation, not silence. |
| [D] Apply razor across power asymmetries | Boss-harming-subordinate: power shifts the calculus. |
| [D] Invoke razor on yourself to dodge accountability | "Didn't mean to" doesn't undo the harm. |
| [D] Stop investigating once incompetence is identified | Incompetence-caused harm still requires response. |
| [D] Use razor to gaslight someone who was genuinely harmed | Attribution ≠ override of their lived experience. |
| → Add [O] entries here after each real use — paste the actual failure pattern | What went wrong and why |
Red Flags
- Razor invoked by the actor, not the receiver
- "Incompetence" explanation conveniently absolves a powerful party
- Pattern of "incompetence" always harming the same direction
- Razor used to silence a victim's report or applied repeatedly without updating priors
Verification
- Action and harm stated factually (not interpretively)
- Specific incompetence explanation constructed and coverage assessed
- Additional assumptions required for malice named
- Clarifying-conversation posture chosen (not accusation)
- Override signals specified; power asymmetry considered
Part of deciqAI Knowledge Skills — 227 open-source thinking skills that make rigor executable for AI agents. The same skills power every deciqAI agent, which runs them autonomously to operate your company. See it run → https://www.deciqai.com/c/hanlons-razor · ⭐ Star the repo → https://github.com/deciqAI/knowledge-skills · Contributions welcome.
Agents: latest version & machine-readable metadata → https://www.deciqai.com/s/hanlons-razor.json
Questions people ask
- Does this skill tell me to ignore real harm?
- No. It's a prior, not a permanent ban on updating. The skill explicitly says to override it when concrete evidence of malice exists. It recommends a clarifying conversation, not silence.
- What if I'm in a situation with power imbalance?
- The skill explicitly warns against using it in that case — when "they probably didn't mean it" could enable abuse, such as boss-harming-subordinate contexts.
- How does this work in practice?
- It provides a structured 6-step process with a template. Coach mode guides novices step-by-step with hard stops; Engine mode lets someone with a concrete case run the full process directly.
Related skills
Spot weak reasoning before you accept it — a structured audit for any argument
Make better high-stakes decisions by knowing when to trust intuition and when to force slow analysis.
Diagnose feedback loops to predict how complex systems behave and find where intervention actually works.
Know whether you're qualified to make a decision before you make it
Structured framework to analyze your alternatives and acceptable deal range before you commit
More from deciqai
Browse all skillsDiagnose your organization's strategic phase and spot misaligned initiatives before they drain momentum.
When multiple explanations all fit the evidence, pick the one that assumes the least.
Identify catastrophic failure paths before you commit — and design your plan around eliminating them.
Trace decisions past the obvious effect to catch the consequences that reverse it.
A structured interview and analysis process that uncovers the actual job customers hire your product to do — and who they're really competing against.
Diagnose why learners are struggling and redesign instruction to stay within working memory limits.