Plan Epic

Collaboratively define milestones for an epic with the user.

Arguments

$ARGUMENTS - Epic ID (e.g., "user-auth") or empty to select from list

Instructions

1. Identify the epic:

   • If $ARGUMENTS provided, find epic file at .roadmap/epics/{epic-id}.md
   • If empty, list available epics and ask user to select one

2. Show current state:

   Epic: User Authentication
   Quarter: 2025-Q1
   Status: planning
   
   Goal: Enable users to securely log in and manage sessions
   
   Current milestones: None defined yet
   

3. Ask about milestone breakdown:

   What are the 2-4 major milestones for this epic?
   
   Think about:
   - Natural delivery checkpoints
   - Dependencies (what needs to be done first?)
   - Demo-able increments
   
   Example milestones:
   - "Auth foundation (login/logout)"
   - "OAuth providers"
   - "Session management"
   

4. For each milestone the user provides:

   a. Clarify scope:

   Milestone: "OAuth providers"
   What's included in this milestone?
   

   b. Estimate together:

   How would you size this milestone?
   
   Reference:
   - Small (5-8 pts): ~1 week of work
   - Medium (10-15 pts): ~1.5-2 weeks
   - Large (18-25 pts): Full sprint (consider splitting)
   

   c. Target sprint:

   Which sprint should this target?
   Available: 2025-W01, 2025-W03, 2025-W05...
   

5. Show capacity impact:

   Milestone Summary:
   | ID | Milestone | Points | Sprint |
   |----|-----------|--------|--------|
   | M1 | Auth foundation | 8 | 2025-W01 |
   | M2 | OAuth providers | 13 | 2025-W03 |
   | M3 | Session mgmt | 5 | 2025-W05 |
   
   Total: 26 points across 3 sprints
   
   Sprint 2025-W01 capacity: 40 pts
   After this epic: 32 pts remaining
   

6. Confirm and save:

   Save these milestones to the epic? [Y/n]
   

7. Update the epic file with:

   • Milestones table filled in
   • total_points calculated
   • Status updated if appropriate

8. Remind about next steps:

   Epic updated with 3 milestones.
   
   Next:
   - /roadmap-planner:plan-sprint to commit milestones
   - /clickup-sync:push to sync to ClickUp