Agent skill
optionality-review
Review code, architecture, plans, or decisions through the lens of strategic optionality. Assesses reversibility, resilience, and future value.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/optionality-review-charly-vibes-wai-2
SKILL.md
Optionality Review
Review this [CODE/ARCHITECTURE/PLAN/DECISION] through the lens of strategic optionality.
(See Quick Reference section below for optionality principles and red/green flags)
Work to Review
[PASTE YOUR WORK OR SPECIFY FILE PATH]
Context (optional)
[Any relevant context: timeline, constraints, uncertainty level]
Phase 1: Decision Classification
First, classify the key decisions using Bezos's framework:
Type 1 (One-Way Doors): Consequential and irreversible
- Require careful, methodical consideration
- Need broad consultation
- Examples: Core architecture, public APIs, major vendor commitments
Type 2 (Two-Way Doors): Changeable and reversible
- Should be made quickly with ~70% information
- Can be changed if wrong
- Examples: Internal tooling, feature flags, config choices
For each major decision in this work:
| Decision | Type | Reversibility | Decision Deadline | Justification |
|---|---|---|---|---|
| [What's being decided] | [1 or 2] | [EASY/MODERATE/HARD/IRREVERSIBLE] | [When must we decide?] | [Why this classification] |
Early Exit: If NO Type 1 decisions identified, output abbreviated report:
- List Type 2 decisions with brief notes
- Recommend: "Proceed quickly - all decisions are reversible"
- Skip Phases 2-6
Phase 2: Alternative Paths
For Type 1 decisions, evaluate the option space (2-4 alternatives):
Current Approach
- Description: [Brief summary]
- Locks in: [What future choices this constrains]
- Enables: [What this makes possible]
Alternative A
- Description: [Different approach]
- Would preserve: [What options stay open]
- Trade-off: [What we'd give up]
Alternative B (if applicable)
- Description: [Another approach]
- Would preserve: [What options stay open]
- Trade-off: [What we'd give up]
Alternative C, D... (add more if needed for complex decisions)
Assessment: Are alternatives adequately explored? [YES/NO] If NO, what should be investigated before committing?
For Type 2 decisions: Don't deep-dive. Briefly note 1-2 alternatives, then move on - speed matters more than exhaustive analysis for reversible decisions.
Phase 3: Exit Costs & Escape Hatches
For Type 1 decisions from Phase 1, map the exit strategy:
| Decision | Reversal Cost | Reversal Time | Escape Hatch |
|---|---|---|---|
| [Choice made] | [LOW/MED/HIGH] | [hours/days/weeks/months] | [Concrete path to undo if needed] |
| [Another choice] | [LOW/MED/HIGH] | [hours/days/weeks/months] | [How to exit] |
Red Flags:
- Irreversible decisions without clear justification
- No escape hatches for major commitments
- Assumptions treated as facts
- "We can refactor later" without a concrete path
Reversibility Score: [1-10] (10 = easily reversible)
Phase 4: Failure Modes & Fallbacks
What if things go wrong?
| Failure Scenario | Probability | Impact | Fallback Plan | Recovery Cost |
|---|---|---|---|---|
| [What could fail] | [L/M/H] | [L/M/H/CRITICAL] | [Plan B] | [time/effort] |
External Dependencies:
- Vendor lock-in: [None / Acceptable / Concerning]
- Technology bets: [Reversible / Locked]
- Regulatory assumptions: [Validated / Assumed]
- Single points of failure identified: [YES/NO]
Resilience Score: [1-10] (10 = multiple fallbacks, graceful degradation)
Convergence Check: If Reversibility ≥7 AND Resilience ≥7, consider skipping to Final Report.
Phase 5: Future Value Assessment
Does this create or destroy options?
Options CREATED
-
[New capability enabled]
- Enables: [What becomes possible]
- Value: [Why this matters]
-
[Another capability]
- Enables: [What becomes possible]
- Value: [Why this matters]
Options DESTROYED (with justification)
- [Closed off possibility]
- Prevents: [What becomes harder/impossible]
- Justified because: [Why trade-off is acceptable]
Growth Potential
- Can scale to 10x: [YES/PARTIALLY/NO]
- Can add features without rewrite: [YES/PARTIALLY/NO]
- Can be extracted/reused: [YES/PARTIALLY/NO]
- Learning/telemetry built in: [YES/NO]
Future Value Score: [1-10] (10 = maximum option creation)
Phase 6: Decision Points & Triggers
Where should we reassess?
| Milestone | What to Assess | Reassess Trigger | Go/No-Go Criteria |
|---|---|---|---|
| [When] | [What we're evaluating] | [What would cause review] | [How to decide] |
| [Next milestone] | [Another assessment] | [Trigger condition] | [Decision criteria] |
| [Future checkpoint] | [Long-term assessment] | [Warning sign] | [How to decide] |
Assumption Validation:
- Key assumptions explicitly stated
- Validation checkpoints defined
- Early warning metrics identified
Final Report
Scores Summary
- Reversibility: [X/10]
- Resilience: [X/10]
- Future Value: [X/10]
- Overall Optionality: [X/10] (average, or lowest score if any ≤3)
Verdict
Optionality Assessment: [FLEXIBLE | BALANCED | LOCKED_IN | CONCERNING]
- FLEXIBLE (8-10): Excellent strategic flexibility
- BALANCED (5-7): Acceptable trade-offs, some lock-in justified
- LOCKED_IN (3-4): Significant constraints, ensure they're intentional
- CONCERNING (1-2): High risk, reconsider approach
Key Findings:
- [Most significant optionality issue or strength]
- [Second finding]
- [Third finding]
Recommendations
Before proceeding:
- [Critical actions to preserve flexibility]
Build in over time:
- [Strategic improvements for future flexibility]
The Bottom Line
[2-3 sentences: Is the level of lock-in appropriate for our uncertainty level? Are we preserving the right options? What's the key trade-off?]
Human review recommended: [YES/NO] Reason: [Why human judgment needed, or why assessment is sufficient]
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?