decision-doclisted

# Decision Doc Skill ## Purpose Document decisions so you (or your team) never ask "why did we do it this way?" again. Lightweight enough to actually use. ## Clarifying Interview ``` Decision Doc Setup: 1. **Decision type:** Technical | Product | Process | Hiring | Investment | Personal 2. **Reversibility:** One-way door | Two-way door | Easily reversible 3. **Stakeholders:** Just me | Team | Cross-functional | Leadership 4. **Timeline:** Need to decide by ___ 5. **Context:** [1-2 sentences on what prompted this] ``` ## Output Format ### Standard Decision Doc ```markdown # Decision: [Clear, specific title] **Status:** 🟡 Proposed | 🟢 Decided | 🔴 Superseded **Date:** [YYYY-MM-DD] **Owner:** [Name] **Stakeholders:** [Names/roles] --- ## Context [2-3 sentences: What situation led to this decision? What problem are we solving?] ## Decision **We will:** [One sentence stating the decision clearly] ## Options Considered ### Option A: [Name] ✅ Selected **Description:** [What this option entails] | Pros | Cons | |------|------| | + Pro 1 | - Con 1 | | + Pro 2 | - Con 2 | **Estimated effort/cost:** [if relevant] ### Option B: [Name] **Description:** [What this option entails] | Pros | Cons | |------|------| | + Pro 1 | - Con 1 | | + Pro 2 | - Con 2 | **Why not chosen:** [1 sentence] ### Option C: Do Nothing **Why not chosen:** [What happens if we don't decide] ## Rationale [2-3 sentences explaining WHY Option A was chosen. What was the deciding factor?] ## Co