View on GitHub

Cross-Disciplinary Software Team Spaces

A Pattern Language

One-Way vs Two-Way Door Decisions

Summary

Speed up decisions by sorting them into two types. Move fast on decisions you can undo. Use careful processes for decisions you can’t reverse.

Context

Software teams make many decisions daily. These range from small code changes to major API updates. Fast decisions help teams move quickly and respond to markets. But moving too fast on big decisions can cause expensive mistakes.

Problem

Teams often treat all decisions the same way. They spend too much time on simple choices or rush through complex ones. This creates bottlenecks or poor outcomes.

Solution

Sort decisions into two types:

Before making any decision, ask: “What kind of door is this?” Then match your process to how easy it is to reverse.

Forces

Implementation

Decision Classification Tools

Primary Classification Framework:

The Reversibility Assessment Matrix:

Factor Two-Way Door (Reversible) Gray Zone One-Way Door (Irreversible)
Financial Cost to Reverse <$10K or <1% of project budget $10K-$100K or 1-10% of budget >$100K or >10% of budget
Time to Reverse <1 week 1 week - 3 months >3 months
External Impact Internal team only Partner/vendor coordination Customer/market-facing changes
Technical Coupling Isolated/modular changes Some dependencies Core system/architecture
Skill Requirements Existing team skills Some new learning required Significant expertise needed
Regulatory/Legal No compliance impact Minor compliance review Major legal/regulatory changes

Classification Process:

  1. Evaluate each factor on the 3-point scale above
  2. Count the scores across all factors
  3. Apply decision rules:
    • All or mostly “Two-Way Door”: Proceed with fast process
    • All or mostly “One-Way Door”: Apply rigorous process
    • Mixed “Gray Zone”: Use escalation criteria (see below)

Quick Classification Questions:

30-Second Check:

If all answers are “Yes” → Two-Way Door. If any answer is “No” → Need deeper analysis.

Context-Specific Classification Guides:

Technology Decisions:

Product Decisions:

Organizational Decisions:

Process Decisions:

Escalation Criteria

When Two-Way Door Decisions Become One-Way:

When to Escalate:

Escalation Process:

  1. Immediate Pause: Stop execution and gather decision stakeholders
  2. Reclassification: Re-evaluate using full assessment matrix with expanded scope
  3. Stakeholder Expansion: Include affected parties not originally consulted
  4. Risk Analysis: Conduct formal risk assessment with mitigation strategies
  5. Decision Authority: Escalate to appropriate decision-making level

Gray Zone Decision Protocol:

When Classification Is Unclear:

Rapid Gray Zone Resolution:

Documentation Templates

Two-Way Door Decision Record:

# Two-Way Door Decision: [Decision Title]
**Date:** [Date]
**Decider(s):** [Name(s) and Role(s)]
**Status:** [Proposed/Decided/Implemented/Reversed]

## Decision Summary
[1-2 sentences describing what was decided]

## Rationale
[Brief explanation of why this decision was made]

## Reversibility Assessment
- **Financial Cost to Reverse:** $[amount] or [percentage]% of budget
- **Time to Reverse:** [timeframe]
- **Dependencies Created:** [list any new dependencies]
- **Exit Strategy:** [how we would undo this if needed]

## Implementation Plan
- **Timeline:** [when this will be implemented]
- **Success Metrics:** [how we'll know it's working]
- **Review Date:** [when we'll reassess this decision]

## Risk Mitigation
- **What could go wrong:** [potential negative outcomes]
- **Early warning signs:** [indicators we should reverse course]
- **Monitoring approach:** [how we'll track impact]

One-Way Door Decision Record:

# One-Way Door Decision: [Decision Title]
**Date:** [Date]
**Decision Authority:** [Name and Role]
**Stakeholders Consulted:** [List all consulted parties]
**Status:** [Proposed/Under Review/Decided/Implemented]

## Executive Summary
[2-3 sentences capturing the decision and its significance]

## Problem Statement
[Detailed description of the problem this decision addresses]

## Options Considered
### Option 1: [Name]
- **Pros:** [advantages]
- **Cons:** [disadvantages]  
- **Cost:** [financial and resource implications]
- **Risk:** [potential negative outcomes]

### Option 2: [Name]
[Repeat format]

### Option 3: [Name]
[Repeat format]

## Decision Rationale
[Detailed explanation of why the chosen option was selected]

## Irreversibility Analysis
- **Why this is one-way:** [specific factors that make reversal difficult/impossible]
- **Cost of reversal:** [detailed breakdown of reversal costs]
- **Point of no return:** [when reversal becomes impossible]
- **Mitigation strategies:** [how we're reducing irreversibility where possible]

## Risk Assessment
### High-Impact Risks
- **Risk:** [description]
- **Probability:** [High/Medium/Low]
- **Impact:** [description of consequences]
- **Mitigation:** [how we're addressing this risk]

### Medium-Impact Risks
[Repeat format]

## Implementation Plan
- **Phase 1:** [initial steps and timeline]
- **Phase 2:** [subsequent steps and timeline]
- **Dependencies:** [what must happen before we can proceed]
- **Success Criteria:** [how we'll measure success]
- **Monitoring Plan:** [ongoing oversight and adjustment mechanisms]

## Stakeholder Impact
- **Team 1:** [how this affects them]
- **Team 2:** [how this affects them]
- **Customers:** [customer impact]
- **Partners:** [partner/vendor impact]

## Communication Plan
- **Internal Announcement:** [how and when we'll communicate internally]
- **External Communication:** [any required external communication]
- **Training/Support:** [what support people will need]

## Review and Learning
- **6-month review:** [what we'll assess]
- **1-year review:** [longer-term evaluation]
- **Success metrics:** [quantitative measures]
- **Learning capture:** [how we'll document lessons learned]

Gray Zone Escalation Record:

# Gray Zone Decision Escalation: [Decision Title]
**Date:** [Date]
**Original Classifier:** [Name and Role]
**Escalation Trigger:** [What caused the escalation]
**Current Status:** [Under Review/Reclassified/Decided]

## Original Classification
[What the decision was originally thought to be and why]

## Escalation Reason
[Specific factors that triggered reclassification]

## Expanded Assessment
### Stakeholder Analysis
- **Additional stakeholders identified:** [who else is affected]
- **Impact expansion:** [how the impact is broader than originally thought]

### Risk Reassessment
- **New risks identified:** [risks not apparent in original assessment]
- **Risk magnitude changes:** [how risk assessment has changed]

### Reversibility Reanalysis
- **New irreversibility factors:** [what makes this harder to reverse than thought]
- **Cost updates:** [revised estimates of reversal costs]

## Final Classification
- **New classification:** [Two-Way Door/One-Way Door]
- **Justification:** [why this is the correct classification]
- **Process to follow:** [which decision process applies]

## Lessons Learned
[What this teaches us about classification for future decisions]

Decision Process Workflows

Two-Way Door Process (Target: 1-5 days):

Day 1: Decision Framing

Day 2-3: Analysis and Consultation

Day 4-5: Decision and Communication

One-Way Door Process (Target: 2-8 weeks):

Week 1: Deep Problem Analysis

Week 2-3: Option Development

Week 4-5: Risk Assessment and Stakeholder Review

Week 6-7: Decision and Planning

Week 8: Communication and Launch

Advanced Decision-Making Techniques

Converting One-Way to Two-Way Doors:

Experimentation Strategies:

Reversibility Engineering:

Decision Quality Improvement:

Common Decision Mistakes:

Quality Checkpoints:

Measurement and Continuous Improvement

Decision Quality Metrics:

Quantitative Measures:

Qualitative Assessment:

Continuous Improvement Process:

Monthly Decision Reviews:

Quarterly Deep Dives:

Annual Framework Evolution:

Examples

Two-Way Door Decisions:

One-Way Door Decisions:

Sources