Roadmap Planning Skill
=== PURPOSE ===
This skill provides procedures for creating and maintaining product roadmaps. The roadmap is the source of truth for feature planning and prioritization.
=== USED BY ===
| Agent | Purpose |
|---|---|
| @agent(product-manager) @ref(CB-AGENT-PM-001) | Primary skill for roadmap work |
=== PREREQUISITES ===
Before using this skill:
- Project goals defined (@ref(CB-BIZ-GOALS-001))
- Requirements gathered
- Stakeholder input available
=== PROCEDURE: Create Roadmap ===
Location: devdocs/business/roadmap.md
Steps:
- Define roadmap timeframe (quarters/months)
- Align with business goals
- Prioritize features using MoSCoW
- Group features into milestones
- Define dependencies between features
- Get stakeholder alignment
- Document in roadmap file
Roadmap Format:
# Product Roadmap
## Vision
[High-level product vision]
## Q1 2026 - Theme: [Theme Name]
### Milestone: [Name] (v1.1.0)
**Target:** [Date]
**Goals:**
- [Goal 1]
- [Goal 2]
**Features:**
| Feature | Priority | Status | Epic |
|---------|----------|--------|------|
| [Name] | Must Have | Planned | #123 |
| [Name] | Should Have | Planned | #124 |
### Milestone: [Name] (v1.2.0)
...
## Q2 2026 - Theme: [Theme Name]
...
=== PROCEDURE: Milestone Planning ===
Purpose: Define and scope milestones
Steps:
- Define milestone goal/theme
- Select features for milestone
- Estimate total scope
- Identify dependencies
- Set target date (coordinate with Delivery Lead)
- Create GitHub milestone
- Link issues to milestone
Milestone Sizing Guidelines:
- Small: 1-2 weeks, 3-5 issues
- Medium: 2-4 weeks, 5-10 issues
- Large: 4-8 weeks, 10-20 issues
=== PROCEDURE: Roadmap Review ===
Purpose: Keep roadmap current
Frequency: Monthly
Steps:
- Review completed milestones
- Update status of in-progress items
- Re-prioritize based on learnings
- Add new features from requirements
- Remove or defer low-priority items
- Communicate changes to stakeholders
- Log changes in buildlog with
#micro-decision
=== PROCEDURE: Priority Framework ===
Purpose: Consistent prioritization
Frameworks:
- MoSCoW - Must/Should/Could/Won't
- RICE - Reach, Impact, Confidence, Effort
- Value vs Effort - Quick wins, big bets, fill-ins, money pits
RICE Scoring:
Score = (Reach × Impact × Confidence) / Effort
Reach: Users affected (number)
Impact: Effect per user (0.25-3)
Confidence: Certainty (0-100%)
Effort: Person-months
=== PROCEDURE: Dependency Mapping ===
Purpose: Identify feature dependencies
Steps:
- List all planned features
- For each feature, identify:
- Technical dependencies
- Feature dependencies
- External dependencies
- Create dependency graph
- Identify critical path
- Flag blocked items
Notation:
→depends on↔mutual dependency⊗external blocker
=== ANTI-PATTERNS ===
Over-Planning
Problem: Detailed roadmap for 12+ months Solution: Detail for 1-2 quarters, themes for further out
No Flexibility
Problem: Rigid roadmap that doesn't adapt Solution: Regular reviews, embrace change
Missing Dependencies
Problem: Features blocked by undocumented dependencies Solution: Explicit dependency mapping
Stakeholder Misalignment
Problem: Roadmap doesn't reflect stakeholder needs Solution: Regular stakeholder reviews
=== RELATED SKILLS ===
| Skill | Relationship |
|---|---|
| @skill(requirements-gathering) | Requirements feed roadmap |
| @skill(issue-management) | Roadmap items become issues |
| @skill(release-management) | Roadmap guides releases |