mcpbeat

Thinking Reversibility

tjboudreaux/thinking-reversibility

Before heavy deliberation, classify the decision as cheap or costly to undo; decide two-way doors fast and stage one-way doors to preserve options.

797 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
928
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-reversibility

The instruction itself

6 sections, as written by the author

Reversibility

Core rule: match process depth to undo cost. Most decisions are cheaper to reverse than they look; irreversible ones deserve deliberation and staged commitment.

When to Use

  • Uncertain how much analysis a decision deserves (tech, process, product, org)
  • Tempted to committee a low-blast-radius choice, or to rush a high-lock-in one
  • Can redesign the move (pilot, flag, abstraction, time-box) to lower undo cost
  • High-stakes choice where acting vs waiting have asymmetric recovery profiles

When NOT to Use

  • Already classified this session—decide at matched depth; do not re-label forever
  • Trivial two-way calls (names, local refactors) where deciding is cheaper than classifying
  • Externally forced move with no optionality (hard deadline, contract, regulation)
  • Correctness gates (security, data integrity) that need the right answer, not speed theater

Procedure

  • Name the decision and undo path. State what would be committed and the concrete reverse move (rollback, migrate back, revoke, re-hire, re-contract).
  • Score reversibility. Assess technical effort, time, money, reputation, dependents, and learning lost if reversed. Classify:
  • Type 2: undo in days, low cost → decide fast
  • Type 1.5: undo in weeks, moderate cost → light structure + monitor
  • Type 1: months or not realistically undoable → deliberate
  • Asymmetric downside / recovery. For Type 1 or 1.5:
  • Acting wrong: downside, recoverable?, recovery cost
  • Not acting: what permanently closes (window, exclusivity, path lock)
  • Rule: recoverable acting downside + permanent inaction loss → staged commit over indefinite delay; catastrophic or third-party harm → refuse or redesign first
  • Option-preserving redesign. Prefer pilots, feature flags, interfaces, versioning, time-boxed vendor terms, or strangler slices that convert Type 1 surface into Type 2 experiments. Deliberate only the residual irreversible core.
  • Match process and commit. Type 2: pick a reasonable option, ship, monitor. Type 1: document assumptions, argue the opposing case, surface to owner if stakes require it. Stop once class and commitment depth are set—do not re-analyze without new undo-cost evidence.

Output

Decision: …
Undo path: …
Class: Type 2 | 1.5 | 1 (factors: …)
Acting downside / recovery: …
Not-acting permanent loss: …
Staging / option-preserving move: …
Process depth: decide-now | pilot | full deliberation
Commitment: …

Verification

  • Falsify: If "we can always change later" has no concrete undo path and cost, treat as more irreversible until proven otherwise.
  • Stop: After class and process depth are set, further taxonomy is waste—execute the matched process.
  • Over-application guard: Do not slow trivial Type 2 work with matrices. Do not use "two-way door" to skip verification on irreversible data, security, or public commitments.

How to use it

Copy the folder

Take tjboudreaux/thinking-reversibility from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.