3.5 KiB
[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.mdand adapt it for your feature.Task Files: Create individual task files in
.plans/[feature-name]/tasks/usingtask-template.mdas your starting point.
Progress Summary
- Research & Strategy Selection 🟡 Planned
- Explore existing patterns
- Evaluate approach options
- Select and document strategy
- T01: [First Implementation Task] - Status: 🟡 Planned
- T02: [Second Implementation Task] - Status: 🟡 Planned
- T03: [Third Implementation Task] - Status: 🟡 Planned
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]
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