Coding

Hanlon's Razor

Try it

Activate when: someone feels a colleague/partner/company did something on purpose to hurt them; a team believes another side is acting in bad faith; someone...

What it does

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…

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

Related skills

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván558 installs18 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.

by Iván533 installs31 stars

More from deciqai

Browse all skills

Rank competing explanations by counting unsupported assumptions, not words or story length.

by deciqai5 installs2 stars

Surface catastrophic failure paths, rank them, and pair high-impact risks with actions and an explicit abort trigger.

by deciqai4 installs2 stars

Trace a decision past its obvious effect to the downstream consequences that reverse it.

by deciqai4 installs2 stars

Diagnose the causal driver behind a user behavior gap by layering what users say, what they do, and why.

by deciqai3 installs2 stars

Diagnose why teams produce dysfunction and design incentives that make the right behavior rational.

by deciqai1 installs3 stars