Initial commit

skills/structured-plan-mode/assets/plan-template.md

@@ -0,0 +1,135 @@
+# [Feature Name] - Plan
+
+> **Template Purpose**: This template provides a structured approach for planning and tracking complex feature implementations. Copy this template to `.plans/[feature-name]/plan.md` and adapt it for your feature.
+>
+> **Task Files**: Create individual task files in `.plans/[feature-name]/tasks/` using `task-template.md` as your starting point.
+
+---
+<!-- PROGRESS SECTION -->
+
+### Progress Summary
+
+* [ ] **Research & Strategy Selection** 🟡 Planned
+  - Explore existing patterns
+  - Evaluate approach options
+  - Select and document strategy
+
+<!-- Task links will be added in Phase 4 - these are placeholders showing the format -->
+* [ ] [**T01**: [First Implementation Task]](tasks/T01.md) - Status: 🟡 Planned
+* [ ] [**T02**: [Second Implementation Task]](tasks/T02.md) - Status: 🟡 Planned
+* [ ] [**T03**: [Third Implementation Task]](tasks/T03.md) - Status: 🟡 Planned
+
+<!-- Add more task links (T04, T05, ...T0N) as needed based on complexity -->
+
+<!-- END PROGRESS SECTION -->
+
+---
+
+## Research & Strategy Selection
+**Status**: 🟡 **Planned**
+
+### Goal
+[Describe the research objective - understand existing patterns, identify approaches, evaluate alternatives]
+
+### Context
+[Explain why this research is needed and what questions need answering]
+
+**Action Items**:
+
+- [ ] Review existing patterns in codebase
+- [ ] Analyze relevant APIs/data sources
+- [ ] Identify 2-4 viable approach options
+- [ ] Present findings and trade-offs to user
+- [ ] Get user confirmation on selected approach
+
+### Strategy Proposals
+
+> **Fill this during research as you discover options**
+
+**Option A: [Approach Name]**
+- Description: [Brief description]
+- Pros: [Benefits]
+- Cons: [Drawbacks]
+
+**Option B: [Approach Name]**
+- Description: [Brief description]
+- Pros: [Benefits]
+- Cons: [Drawbacks]
+
+**Option C: [Approach Name]** (if applicable)
+- Description: [Brief description]
+- Pros: [Benefits]
+- Cons: [Drawbacks]
+
+### Selected Approach
+
+> **IMPORTANT**: Fill this section AFTER user confirms the selected strategy
+
+**Decision**: [Which approach was selected - Option A/B/C or hybrid]
+
+**Rationale**: [Why this approach was chosen over alternatives]
+
+**Key Findings**:
+- [Finding 1 from research]
+- [Finding 2 from research]
+- [Finding 3 from research]
+
+**Implementation Plan**:
+- [High-level step 1]
+- [High-level step 2]
+- [High-level step 3]
+- [High-level step 4]
+- [High-level step 5]
+
+### Dependencies
+- [External dependency 1]
+- [External dependency 2]
+
+### Related Files
+- `[file/path/here]` - Description
+
+---
+
+## Implementation Tasks
+
+> Task files will be created in the `tasks/` subfolder during Phase 4 of the structured plan mode workflow.
+
+---
+
+## Lessons Learned (Post-Implementation)
+
+> Fill this section out after completing the feature
+
+### What Went Well
+- [Success 1]
+- [Success 2]
+
+### What Could Be Improved
+- [Area for improvement 1]
+- [Area for improvement 2]
+
+### Unexpected Challenges
+- [Challenge 1 and how it was resolved]
+- [Challenge 2 and how it was resolved]
+
+### Recommendations for Future Features
+- [Recommendation 1]
+- [Recommendation 2]
+
+---
+
+
+<!-- META_INFORMATION -->
+## Task Status Legend
+- 🔴 **Blocked**: Requires external dependency or decision
+- 🟡 **Planned**: Ready to implement
+- 🟢 **In Progress**: Currently being worked on
+- ✅ **Completed**: Done
+
+## Change Log
+
+- **YYYY-MM-DD HH:MM**: Initial task breakdown
+- **YYYY-MM-DD HH:MM**: Research completed - [selected approach]
+- **YYYY-MM-DD HH:MM**: T0X completed - [brief description of what was done]
+- **YYYY-MM-DD HH:MM**: Updated T0Y based on new findings
+<!-- META_INFORMATION -->