1  # {Feature Name} Implementation Plan
  2  
  3  **cspec source**: `project/descriptive-docs/machine/{feature}.cspec`  
  4  **Status**: Draft | Under Review | Approved | In Progress | Complete  
  5  **Created**: YYYY-MM-DD  
  6  **Last Updated**: YYYY-MM-DD  
  7  
  8  ---
  9  
 10  ## Overview
 11  
 12  [2-3 paragraph description of what this feature does and why it matters. Written for stakeholders who may not be deeply technical.]
 13  
 14  ## Problem Statement
 15  
 16  [What problem does this solve? What's the current pain point?]
 17  
 18  ## Proposed Solution
 19  
 20  [High-level description of the approach. Link to relevant architecture decisions.]
 21  
 22  ## Rationale
 23  
 24  ### Why This Approach?
 25  
 26  [Explain the reasoning behind key design decisions]
 27  
 28  ### Alternatives Considered
 29  
 30  | Alternative | Pros | Cons | Why Rejected |
 31  |-------------|------|------|--------------|
 32  | Option A | ... | ... | ... |
 33  | Option B | ... | ... | ... |
 34  
 35  ## Specification Summary
 36  
 37  [Human-readable expansion of the cspec. This section can be auto-generated from the cspec file.]
 38  
 39  ### Components Affected
 40  
 41  - [ ] Component 1 — description of changes
 42  - [ ] Component 2 — description of changes
 43  
 44  ### Key Parameters
 45  
 46  | Parameter | Value | Notes |
 47  |-----------|-------|-------|
 48  | ... | ... | ... |
 49  
 50  ## Implementation Phases
 51  
 52  ### Phase 1: {Phase Name}
 53  
 54  **Duration**: X weeks  
 55  **Dependencies**: [list]
 56  
 57  **Tasks**:
 58  1. Task description
 59  2. Task description
 60  
 61  **Deliverables**:
 62  - Deliverable 1
 63  - Deliverable 2
 64  
 65  **Success Criteria**:
 66  - [ ] Criterion 1
 67  - [ ] Criterion 2
 68  
 69  ### Phase 2: {Phase Name}
 70  
 71  [Repeat structure]
 72  
 73  ## Risk Assessment
 74  
 75  | Risk | Likelihood | Impact | Mitigation |
 76  |------|------------|--------|------------|
 77  | ... | Low/Med/High | Low/Med/High | ... |
 78  
 79  ## Open Questions
 80  
 81  - [ ] Question 1 — [context/options]
 82  - [ ] Question 2 — [context/options]
 83  
 84  ## Dependencies
 85  
 86  - **Blocks**: [What this plan blocks]
 87  - **Blocked by**: [What blocks this plan]
 88  - **Related**: [Related plans/features]
 89  
 90  ## Testing Strategy
 91  
 92  [How will this be tested? What environments? What coverage?]
 93  
 94  ## Rollout Plan
 95  
 96  [How will this be deployed? Phased? Feature flagged?]
 97  
 98  ## Approval
 99  
100  | Role | Name | Date | Status |
101  |------|------|------|--------|
102  | Technical Lead | | | ⬜ Pending |
103  | Architecture | | | ⬜ Pending |
104  | Stakeholder | | | ⬜ Pending |
105  
106  ---
107  
108  ## Changelog
109  
110  | Date | Author | Changes |
111  |------|--------|---------|
112  | YYYY-MM-DD | Name | Initial draft |