Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.
Coding
Hanlon's Razor
Try itActivate 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.
- 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
Related skills
Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.
Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.
Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.
Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.
Save, search, and manage personal notes and knowledge bases in Get笔记 on explicit request.
More from deciqai
Browse all skillsRank competing explanations by counting unsupported assumptions, not words or story length.
Surface catastrophic failure paths, rank them, and pair high-impact risks with actions and an explicit abort trigger.
Trace a decision past its obvious effect to the downstream consequences that reverse it.
Diagnose the causal driver behind a user behavior gap by layering what users say, what they do, and why.
Decompose complex problems into non-overlapping, gap-free categories and pinpoint the load-bearing branch.
Diagnose why teams produce dysfunction and design incentives that make the right behavior rational.