Skip to main content
The Hard Parts.dev
TD-16 Product Delivery TD Tech Decisions
Severity if wrong · high Freq · common

One-Way Door vs Two-Way Door Rollout

Usually a reversibility and blast-radius decision.

Severity if wrong
high
Frequency
common
Audiences
release managers · platform teams · tech leads
Reversibility
this entry is about reversibility
Confidence
high
At a glanceTD-16
Really about
How much safety comes from keeping options open versus committing fully.
Not actually about
Whether confidence is high in a meeting.
Why it feels hard
Irreversible changes can be cleaner and faster; reversible changes are safer but often more complex.

The decision

Is this change hard to reverse, or can we rollout in a reversible way?

Usually a reversibility and blast-radius decision.

Default stance

Where to start before any evidence arrives.

Prefer two-way doors when uncertainty is high and rollback is feasible.

Options on the table

Two poles of the trade-off

Neither is the right answer by default. Each option's conditions, strengths, costs, hidden costs, and failure modes when misused are laid out in parallel so you can read across facets.

Option A

One-Way Door

Best when

Conditions where this option is a natural fit.

  • commitment is intentional
  • reversal cost is acceptable only because confidence is high
  • dual-running or gradual fallback is impractical

Real-world fits

Concrete environments where this option has worked.

  • schema migrations with no dual-running path
  • sunsetting legacy platforms after explicit readiness criteria
  • irreversible vendor or protocol cutovers

Strengths

What this option does well on its own terms.

  • clarity
  • less temporary complexity
  • faster commitment

Costs

What you accept up front to get those strengths.

  • higher risk if wrong
  • stronger need for upfront confidence

Hidden costs

Costs that surface later than expected — the main thing novices miss.

  • organizations often overestimate certainty

Failure modes when misused

How this option breaks when applied to the wrong context.

  • Creates abrupt, high-blast-radius transitions.

Option B

Two-Way Door

Best when

Conditions where this option is a natural fit.

  • rollback matters
  • uncertainty is material
  • gradual migration or flags are feasible

Real-world fits

Concrete environments where this option has worked.

  • feature-flagged rollouts
  • progressive migrations
  • canary and staged deployments

Strengths

What this option does well on its own terms.

  • safer experimentation
  • lower blast radius
  • better learning

Costs

What you accept up front to get those strengths.

  • temporary complexity
  • dual state management

Hidden costs

Costs that surface later than expected — the main thing novices miss.

  • temporary rollback paths can become permanent clutter

Failure modes when misused

How this option breaks when applied to the wrong context.

  • Creates long-lived transitional complexity nobody retires.

Cost, time, and reversibility

Who pays, how it ages, and what undoing it costs

Trade-offs are rarely zero-sum and rarely static. Someone pays, the payoff curve shifts with the horizon, and the decision has an undo cost.

Cost bearer

Option A · One-Way Door

Who absorbs the cost

  • Operations
  • Support
  • All affected consumers if wrong

Option B · Two-Way Door

Who absorbs the cost

  • Delivery team managing temporary complexity
Time horizon

Option A · One-Way Door

Wins when certainty is unusually high and transitional complexity is too costly.

Option B · Two-Way Door

Wins when learning under controlled risk is more valuable than clean-looking commitment.

Reversibility

What undoing costs

This entry is about reversibility

What should force a re-look

Trigger conditions that mean the answer may have changed.

  • Confidence improves
  • Migration burden grows

How to decide

The work you still have to do

The reference can frame the trade-off; only you can weight the factors against your context.

Questions to ask

Open these in the room. Answering them is most of the decision.

  • What would rollback actually require in practice?
  • Have we rehearsed the reversal path?
  • How much uncertainty still exists?
  • What temporary complexity are we willing to tolerate for safety?

Key factors

The variables that actually move the answer.

  • Reversibility
  • Blast radius
  • Confidence level
  • Migration feasibility

Evidence needed

What to gather before committing. Not after.

  • Rollback plan
  • Blast-radius assessment
  • Cutover rehearsal results
  • Dependency and state transition map

Signals from the ground

What's usually pushing the call, and what should

On the left, pressures to recognize and discount. On the right, signals that genuinely point toward one option or the other.

What's usually pushing the call

Pressures to recognize and discount.

Common bad reasons

Reasoning that feels convincing in the moment but doesn't hold up.

  • We will know if it fails
  • Rollback is always easy

Anti-patterns

Shapes of reasoning to recognize and set aside.

  • Calling a change reversible without testing rollback
  • Leaving temporary rollback paths in place forever

What should push the call

Concrete signals that genuinely point to one pole.

For · One-Way Door

Observations that genuinely point to Option A.

  • High certainty
  • Rollback complexity exceeds benefit

For · Two-Way Door

Observations that genuinely point to Option B.

  • Uncertain impact
  • Controlled rollout is feasible

AI impact

How AI bends this decision

Where AI accelerates the call, where it introduces new distortions, and anything else worth knowing.

AI can help with

Where AI genuinely reduces the cost of making the call.

  • AI can help enumerate rollback paths and rollout hazards.

AI can make worse

Distortions AI introduces that didn't exist before.

  • AI-generated rollout scripts can create false confidence in reversibility.

Relationships

Connected decisions

Nearby decisions this is sometimes confused with, adjacent decisions that are often entangled with this one, related failure modes, red flags, and playbooks to reach for.

Easy to confuse with

Nearby decisions and how this one differs.

  • That decision is about commitment axes at the plan level. This one is about reversibility at the change level.

  • That decision is about the mechanism for controlled release. This one is about how reversible the underlying change is regardless of mechanism.

  • Adjacent concept A rollback-plan decision

    A rollback plan is the artifact. This decision is whether reversibility is actually achievable.