thinking-reversibility
Skill2 starsChanged 9 months agoMITView on GitHub
Classify decisions by reversibility and match decision process to decision type. Use for technology choices, architecture decisions, process changes, and hiring decisions.
In this repository38 other files it gives its agents.
- thinking-archetypesSkill
- thinking-bayesianSkill
- thinking-bounded-rationalitySkill
- thinking-circle-of-competenceSkill
- thinking-cynefinSkill
- thinking-debiasingSkill
- thinking-dual-processSkill
- thinking-effectuationSkill
- thinking-feedback-loopsSkill
- thinking-fermi-estimationSkill
- thinking-first-principlesSkill
- thinking-five-whys-plusSkill
- thinking-inversionSkill
- thinking-jobs-to-be-doneSkill
- thinking-kepner-tregoeSkill
- thinking-leverage-pointsSkill
- thinking-lindy-effectSkill
- thinking-map-territorySkill
- thinking-margin-of-safetySkill
- thinking-model-combinationSkill
- thinking-model-routerSkill
- thinking-model-selectionSkill
- thinking-occams-razorSkill
- thinking-oodaSkill
- thinking-opportunity-costSkill
- thinking-pre-mortemSkill
- thinking-probabilisticSkill
- thinking-red-teamSkill
- thinking-regret-minimizationSkill
- thinking-scientific-methodSkill
- thinking-second-orderSkill
- thinking-socraticSkill
- thinking-steel-manningSkill
- thinking-systemsSkill
- thinking-theory-of-constraintsSkill
- thinking-thought-experimentSkill
- thinking-trizSkill
- thinking-via-negativaSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 179
Create reversibility through interfaces:
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Reversibility Thinking
Overview
Jeff Bezos distinguishes between Type 1 (irreversible, one-way door) and Type 2 (reversible, two-way door) decisions. The key insight: most decisions are Type 2 but get treated as Type 1, causing analysis paralysis. Match your decision process to the reversibility of the decision.
Core Principle: Reversible decisions should be made quickly by individuals. Irreversible decisions deserve deliberation. Most decisions are more reversible than they appear.
When to Use
- Technology choices
- Architecture decisions
- Process changes
- Hiring decisions
- Feature implementations
- Organizational changes
- Any decision where you're uncertain how much analysis is warranted
Decision flow:
Decision to make?
→ Is it easily reversible? → yes → DECIDE QUICKLY (Type 2)
→ Is it hard/impossible to reverse? → yes → DELIBERATE CAREFULLY (Type 1)
→ Unsure of reversibility? → ANALYZE REVERSIBILITY FIRSTType 1 vs Type 2 Decisions
Type 1: One-Way Doors
Characteristics:
- Irreversible or very costly to reverse
- Consequences are significant and lasting
- Changing course means starting over
Examples:
- Fundamental architecture choices (monolith vs microservices for core systems)
- Major technology platform (cloud provider for critical infra)
- Hiring for leadership positions
- Shutting down a product line
- Major acquisitions or contracts
- Public commitments or promises
Process:
- Extensive analysis
- Multiple stakeholder input
- Devil's advocate review
- Documentation of reasoning
- Senior decision maker
Type 2: Two-Way Doors
Characteristics:
- Easily reversed if wrong
- Limited blast radius
- Can iterate and adjust
Examples:
- Most feature implementations
- UI/UX changes
- Internal tool selection
- Process experiments
- Meeting cadences
- Individual hiring decisions
- Marketing campaigns
Process:
- Decide quickly
- Empower individuals/small teams
- Monitor results
- Adjust as needed
- Don't over-analyze
The Reversibility Analysis
Step 1: Assess True Reversibility
| Factor | Question | Impact on Reversibility |
| Technical cost | How hard to undo technically? | High cost = less reversible |
| Time cost | How long to reverse? | Months = less reversible |
| Financial cost | How expensive to change? | High cost = less reversible |
| Reputation cost | Will reversal damage trust? | Yes = less reversible |
| Learning cost | Will we lose the learning? | Critical learning = more complex |
| Dependency cost | Have others built on this? | Many dependents = less reversible |
Step 2: Categorize the Decision
Reversibility Score:
- Can undo in days with minimal cost: TYPE 2 (two-way door)
- Can undo in weeks with moderate cost: TYPE 2 with monitoring
- Can undo in months with significant cost: TYPE 1.5 (evaluate carefully)
- Cannot realistically undo: TYPE 1 (one-way door)Step 3: Match Process to Type
| Decision Type | Process | Time | Decision Maker |
| Type 1 | Full analysis, stakeholder review | Days-weeks | Senior leadership |
| Type 1.5 | Structured analysis, peer review | Days | Team lead + stakeholders |
| Type 2+ | Quick analysis, document rationale | Hours | Individual/small team |
| Type 2 | Just decide | Minutes | Individual |
Common Reversibility Misclassifications
Treating Type 2 as Type 1
Decision: Which logging library to use
Common mistake: Extensive evaluation, committee decision, weeks of analysis
Reality: Can swap libraries in a day; dependencies are isolated
Correct approach: Engineer picks one, team evaluates after 2 weeks
Cost of over-deliberation: Weeks of productivity lostTreating Type 1 as Type 2
Decision: Database technology for core product
Common mistake: Quick decision because "we can always change later"
Reality: Changing databases means rewriting queries, data migration, retraining
Correct approach: Thorough evaluation, prototype, stakeholder alignment
Cost of under-deliberation: Months of migration pain laterHidden Reversibility
Some seemingly irreversible decisions are actually reversible:
"We can't change our API because clients depend on it"
Reality: Versioning makes this reversible
v1 continues, v2 adds improvements
"We can't change the architecture"
Reality: Strangler pattern enables gradual change
Migrate piece by pieceHidden Irreversibility
Some seemingly reversible decisions lock you in:
"It's just a prototype, we can rewrite later"
Reality: Prototypes often become production
"Temporary" code lives for years
"We can always switch cloud providers"
Reality: Deep integration creates massive switching cost
Proprietary services create lock-inReversibility Patterns
The Pilot Pattern
Turn Type 1 into Type 2 through limited rollout:
Type 1: "Adopt new framework for entire codebase"
Piloted: "Use new framework for one service"
→ Now it's Type 2: Can abandon pilot with limited impact
→ If successful, expand incrementallyThe Abstraction Pattern
Create reversibility through interfaces:
Type 1: "Choose between Postgres and MySQL"
With abstraction: "Define data layer interface, start with Postgres"
→ Can swap implementation later
→ Cost of reversal dramatically reducedThe Time-Box Pattern
Make long commitments into short experiments:
Type 1: "Commit to vendor for 3 years"
Time-boxed: "Start with 6-month pilot"
→ Can exit at known cost
→ Full commitment only after validationThe Feature Flag Pattern
Deploy with reversibility built in:
Type 1: "Launch new pricing model"
With flags: "Launch to 5% of users, flag-controlled"
→ Can disable instantly
→ Expand only when confidentDecision Speed Guidance
Decisions to Make in Minutes
- Which test to write first
- Variable naming
- Comment wording
- Which task to pick up next
- Slack message tone
Decisions to Make in Hours
- Library choices (within approved options)
- Implementation approach for a feature
- Meeting agenda
- Code organization within a module
- Bug fix approach
Decisions to Make in Days
- Design patterns for new components
- API contract changes
- Team process changes
- Tool adoption
- Architectural changes to non-critical services
Decisions to Make in Weeks
- Core architecture decisions
- Platform/infrastructure choices
- Significant hiring decisions
- Large feature scope
- Strategic priorities
Reversibility Template
# Reversibility Analysis: [Decision]
## The Decision
[What we're deciding]
## Reversibility Assessment
| Factor | Assessment | Score (1-5) |
|--------|------------|-------------|
| Technical effort to reverse | [Details] | |
| Time to reverse | [Duration] | |
| Financial cost to reverse | [Cost] | |
| Reputation impact of reversal | [Impact] | |
| Dependencies affected | [Count/scope] | |
| Learning lost if reversed | [Value] | |
Average: [X]
- 1-2: Clear Type 2
- 3: Type 1.5
- 4-5: Type 1
## Decision Type: [Type 1 / 1.5 / 2]
## Appropriate Process
- Analysis depth: [Minimal / Moderate / Extensive]
- Decision maker: [Individual / Team / Leadership]
- Time to decide: [Minutes / Hours / Days / Weeks]
- Documentation: [None / Brief / Full]
## Can We Increase Reversibility?
- Pilot: [Option]
- Abstraction: [Option]
- Time-box: [Option]
- Feature flag: [Option]
## Decision
[The choice made]
## Reversal Plan (if needed)
[How we would reverse if this proves wrong]Verification Checklist
- Assessed reversibility across multiple factors
- Categorized as Type 1, 1.5, or 2
- Matched decision process to decision type
- Explored options to increase reversibility
- Not over-analyzing Type 2 decisions
- Not under-analyzing Type 1 decisions
- Have a reversal plan for non-trivial decisions
Key Questions
- "How hard would it be to undo this?"
- "Are we treating this like a one-way door when it's actually two-way?"
- "Can we pilot this to make it more reversible?"
- "What's the cost of being wrong vs. the cost of delay?"
- "Who else would be affected if we reverse?"
- "Is this actually irreversible, or does it just feel that way?"
Bezos' Wisdom
"Some decisions are consequential and irreversible or nearly irreversible – one-way doors – and these decisions must be made methodically, carefully, slowly, with great deliberation and consultation."
"But most decisions aren't like that – they are changeable, reversible – they're two-way doors. If you've made a suboptimal Type 2 decision, you don't have to live with the consequences for that long. You can reopen the door and go back through."
"As organizations get larger, there seems to be a tendency to use the heavy-weight Type 1 decision-making process on most decisions, including many Type 2 decisions. The end result of this is slowness, unthoughtful risk aversion, failure to experiment sufficiently, and consequently diminished invention."
Speed matters. Most decisions are reversible. Decide, learn, adjust.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

