.agents/skills/optionality-review/SKILL.md
Review code, architecture, plans, or decisions through the lens of strategic optionality. Assesses reversibility, resilience, and future value.
npx skillsauth add charly-vibes/wai optionality-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Review this [CODE/ARCHITECTURE/PLAN/DECISION] through the lens of strategic optionality.
(See Quick Reference section below for optionality principles and red/green flags)
[PASTE YOUR WORK OR SPECIFY FILE PATH]
[Any relevant context: timeline, constraints, uncertainty level]
First, classify the key decisions using Bezos's framework:
Type 1 (One-Way Doors): Consequential and irreversible
Type 2 (Two-Way Doors): Changeable and reversible
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:
For Type 1 decisions, evaluate the option space (2-4 alternatives):
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.
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:
Reversibility Score: [1-10] (10 = easily reversible)
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:
Resilience Score: [1-10] (10 = multiple fallbacks, graceful degradation)
Convergence Check: If Reversibility ≥7 AND Resilience ≥7, consider skipping to Final Report.
Does this create or destroy options?
[New capability enabled]
[Another capability]
Future Value Score: [1-10] (10 = maximum option creation)
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:
Optionality Assessment: [FLEXIBLE | BALANCED | LOCKED_IN | CONCERNING]
Key Findings:
Before proceeding:
Build in over time:
[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]
testing
Compare original and distilled prompts to verify the distillation is faithful and lossless. Checks completeness, accuracy, and appropriate conciseness.
development
Implement features following Test-Driven Development methodology. Red-Green-Refactor cycle with phased approach and verification at each step.
development
Orchestrate multi-agent code review with three waves - parallel analysis, cross-validation, and convergence check. Simulates specialist reviewers and synthesizes findings.
development
Apply Steve Yegge's Rule of 5 iterative review to any artifact - code, plans, research, issues, specs, or documents. Five stages from draft through excellence.