Skip to content
Development
Agent

reversibility-and-process

Not every decision deserves a matrix. The first move is always to classify the decision, because the right *process* depends far more on **reversibility** than on the topic. Spending a week of analysis on a choice you can undo in an hour is itself a failure mode (analysis

From plugin
skills
954 skills54 agents

Claude Code

$ npx -y skills add vanara-agents/skills --agent claude-code

Agent definition

reversibility-and-process.md

Reversibility and process โ€” match the rigor to the decision

Not every decision deserves a matrix. The first move is always to classify the decision, because the right *process* depends far more on **reversibility** than on the topic. Spending a week of analysis on a choice you can undo in an hour is itself a failure mode (analysis paralysis); waving through an irreversible choice on a hunch is the opposite one.

One-way vs two-way doors

  • **Two-way door (reversible).** You can walk back through it cheaply if you're wrong. Most decisions

are these: a library choice inside one module, a config default, a naming convention, an experiment. **Process:** pick a sensible default fast, write down the assumption, move on. Optimize for *speed of learning*, not correctness on the first try. A full matrix here is ceremony.

  • **One-way door (hard to reverse).** Undoing it is expensive, slow, or impossible: a public API

contract, the data model, a persistence engine, a security boundary, a vendor you'll build deep dependencies on, a decision that sheds trust or people. **Process:** this is where the weighted matrix, the sensitivity check, and a written record earn their cost. Slow down on purpose.

The trap is misclassifying: teams routinely agonize over reversible choices and rush the irreversible ones. **Classify the door first**, then spend your reasoning budget accordingly.

Timeboxing

Give the decision a time budget proportional to its reversibility and stakes, and hold to it. For a two-way door, "decide by end of day, revisit if it hurts" is usually right. For a one-way door, a longer box is warranted โ€” but an open-ended one invites paralysis. When the box expires, decide with what you have and record the open question; a made decision with a flagged risk beats an unmade one.

Widen the options before you score them (WRAP)

Weighted matrices assume you already have the right options on the table. Often the real failure is upstream โ€” a narrow or false choice. The WRAP process (Heath & Heath, *Decisive*) guards the inputs:

  • **W โ€” Widen your options.** Beware "whether or not" framing (it hides that there are usually more

than two choices). Ask "what else could we do?"; consider the opportunity cost ("if we couldn't do any of these, what would we do?"); look for someone who has already solved this.

  • **R โ€” Reality-test your assumptions.** Seek disconfirming evidence, not confirmation. Ask what would

have to be true for each option to be the right one, then check it. Run a small, cheap test where you can (a spike, a prototype, a pilot) instead of arguing in the abstract.

  • **A โ€” Attain distance before deciding.** Fight in-the-moment emotion and short-term bias. Useful

prompts: "what would I tell my best friend to do?"; "what would a successor with no attachment to the current path do?"; "how will this look in 10 minutes / 10 months / 10 years?".

  • **P โ€” Prepare to be wrong.** You will sometimes pick the losing option; plan for it. Set a **tripwire**

โ€” a pre-committed condition that triggers a re-decision ("if error rate exceeds X for a week, we revisit"). Run a **premortem**: imagine it's a year later and this failed โ€” why? Then mitigate the top causes now.

The matrix scores the options; WRAP makes sure you're scoring the *right* options and staying honest about the evidence.

Premortem (the highest-leverage 10 minutes)

Before committing, ask everyone to assume the decision has already failed spectacularly and write down why. It surfaces risks that optimism suppresses during normal planning, and it does so without anyone having to be the lone naysayer. Feed the top failure causes back into the criteria (as risks to weight) and into the tripwires (as conditions to monitor).

Putting it together

1. **Classify the door.** Two-way โ†’ fast default, record the assumption, done. One-way โ†’ continue. 2. **Widen** (WRAP-W) so you're not choosing from a false menu. 3. Build and score the **weighted matrix** (`weighted-decision-matrix.md`). 4. **Reality-test** the decisive scores/weights (WRAP-R) and run the **sensitivity check**. 5. **Attain distance**, run a **premortem**, and set a **tripwire** for revisiting. 6. Record the decision and its rationale so it isn't re-litigated from scratch next quarter.

Read more
@vanara-agents
Ships withskills

๐Ÿ’ Free agents, skills & packs for Claude Code One subscription. An army of Claude Code agents. 30 production-grade agents, skills, and packs for Claude Code โ€” free, Apache-2.0, install with one command.

917 skills54 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
9
Star history of vanara-agents/skills on GitHub, a chart by star-history.com

Other agents on skills.

AGENT

AGENT

Agent

Use when designing a new HTTP/GraphQL API or changing an existing one โ€” modeling resources, defining endpoint contracts, choosingโ€ฆ

review-notes

review-notes

Agent

This shows how the api-designer agent reviews a flawed draft. Findings are severity-ranked so the implementer fixes theโ€ฆ

contract-and-openapi

contract-and-openapi

Agent

The contract is the deliverable. Express it as an **OpenAPI 3.1** document so it is human-readable *and* machine-checkable. Thisโ€ฆ

design-checklist

design-checklist

Agent

Run through this before declaring an API contract done. It is ordered the way you should *design*: resources first, cross-cuttingโ€ฆ

versioning-and-evolution

versioning-and-evolutiโ€ฆ

Agent

APIs are forever once published: a consumer you've never met may depend on any field you expose. Design so you can **add withoutโ€ฆ

pr-comment-template

pr-comment-template

Agent

Copy-paste templates for leaving review comments. Keep each comment to one finding: an anchor, the problem, and the fix.

More agents from other plugins.

a11y-architect
Auto-invoked

a11y-architect

Agent

Accessibility Architect specializing in WCAG 2.2 compliance for Web and Native platforms. Use PROACTIVELY when designing UIโ€ฆ

ecc12d293k
@affaan-m@affaan-mInstall Agent
analyze-pass-impact

analyze-pass-impact

Agent

Analyzes how a specific topic affects a group of compiler passes. Used by the /plan-update skill to parallelize research acrossโ€ฆ

react2d252k
@facebook@facebookInstall Agent
orchestrator

orchestrator

Agent

- If the user makes a simple request (such as asking for the time) which you can fulfill by running a terminal command (such asโ€ฆ

codex1d135k
@openai@openaiInstall Agent
cavecrew-builder

cavecrew-builder

Agent

Surgical 1-2 file edit. Typo fixes, single-function rewrites, mechanical renames, comment removal, format-preserving tweaks. Hardโ€ฆ

caveman2d119k
@juliusbrussee@juliusbrusseeInstall Agent

Questions about reversibility-and-process.

Which coding agents can use reversibility-and-process?
reversibility-and-process installs in Claude Code and Cursor: each loads subagents from .claude/agents, so copy the file there. Flowy's auto-invocation runs in Claude Code only.