Coding

Hanlon's Razor

Try it

Pause 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.

  1. One-line: before believing someone did it on purpose, construct the mistake version — see how much evidence it covers.
  2. Check fit: concrete malice evidence / catastrophic cost of being wrong → not this lens.
  3. Elicit the specific incident — what exactly happened?

[WAIT — do not advance until user responds]

  1. Work through The Process one step at a time with their input.

[WAIT — do not advance until user responds]

  1. 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

SituationDefault maliceLikely 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 moveReality
[D] Apply razor then ignore mounting evidence of maliceIt's a prior, not a permanent ban on updating.
[D] Use razor to avoid hard conversationsIt recommends a clarifying conversation, not silence.
[D] Apply razor across power asymmetriesBoss-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 identifiedIncompetence-caused harm still requires response.
[D] Use razor to gaslight someone who was genuinely harmedAttribution ≠ override of their lived experience.
→ Add [O] entries here after each real use — paste the actual failure patternWhat 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 when a single impression is distorting all your ratings — and get a structured fix.

by deciqai1 installs2 stars

Spot weak reasoning before you accept it — a structured audit for any argument

by deciqai2 stars

Diagnose feedback loops to predict how complex systems behave and find where intervention actually works.

by deciqai1 installs3 stars

Know whether you're qualified to make a decision before you make it

by deciqai1 installs3 stars

Structured framework to analyze your alternatives and acceptable deal range before you commit

by deciqai1 installs3 stars

More from deciqai

Browse all skills

Diagnose your organization's strategic phase and spot misaligned initiatives before they drain momentum.

by deciqai7 installs2 stars

When multiple explanations all fit the evidence, pick the one that assumes the least.

by deciqai5 installs2 stars

Identify catastrophic failure paths before you commit — and design your plan around eliminating them.

by deciqai4 installs2 stars

Trace decisions past the obvious effect to catch the consequences that reverse it.

by deciqai4 installs2 stars

A structured interview and analysis process that uncovers the actual job customers hire your product to do — and who they're really competing against.

by deciqai3 installs3 stars

Diagnose why learners are struggling and redesign instruction to stay within working memory limits.

by deciqai2 installs3 stars