skills/roadmap-planning/SKILL.md
Annual and quarterly roadmap planning for engineering teams. Use when: building or updating a team roadmap, prioritizing initiatives, mapping dependencies across teams, preparing roadmap presentations for leadership, evaluating trade-offs between competing priorities, or aligning roadmap items to company strategy and OKRs.
npx skillsauth add michaelsvanbeek/personal-agent-skills roadmap-planningInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A roadmap is not a feature list. It communicates what the team intends to accomplish, why, and in what sequence — at a level of abstraction appropriate for the audience.
| Element | Description | |---------|-------------| | Theme | High-level area of investment (e.g., "Platform reliability", "Self-serve onboarding") | | Initiative | A scoped body of work within a theme, deliverable within a quarter | | Outcome | The measurable result the initiative produces (tied to OKR or business metric) | | Owner | The person or squad accountable for delivery | | Dependencies | Teams, services, or decisions this initiative depends on | | Confidence | High / Medium / Low — how certain is this commitment? | | Time horizon | Now (this sprint), Next (this quarter), Later (future quarter) |
Before planning, collect:
List all potential initiatives. For each, capture:
### Initiative: <Name>
- **Theme**: <which strategic area>
- **Problem**: <what problem does this solve>
- **Outcome**: <what measurable result>
- **Effort**: S / M / L / XL
- **Impact**: High / Medium / Low
- **Confidence**: High / Medium / Low
- **Dependencies**: <list any cross-team dependencies>
- **Requestor**: <who is asking for this>
Use a structured framework. Do not priority-sort by gut feeling alone.
| Factor | Definition | Scale | |--------|-----------|-------| | Reach | How many users/teams/customers are affected? | Number or % | | Impact | How much does it improve the outcome? | 3 = massive, 2 = high, 1 = medium, 0.5 = low | | Confidence | How sure are we about reach and impact? | 100% / 80% / 50% | | Effort | Person-weeks to deliver | Number |
RICE Score = (Reach × Impact × Confidence) / Effort
For simpler prioritization, plot initiatives on a 2×2:
High Value
│
DO FIRST│ PLAN CAREFULLY
(quick │ (high effort,
wins) │ high value)
────────────┼──────────────── Effort →
FILL │ AVOID / DEFER
(low │ (high effort,
value, │ low value)
easy) │
Low Value
Split team capacity deliberately:
| Category | Target % | Examples | |----------|----------|---------| | Roadmap features | 60–70% | New capabilities, customer-facing work | | Tech debt / platform | 15–20% | Reliability, performance, developer experience | | Support / unplanned | 10–15% | Bugs, incidents, ad hoc requests | | Growth / learning | 5% | Spikes, prototypes, skill development |
Document the allocation in your quarterly plan so the team and stakeholders share expectations.
Arrange initiatives into time horizons:
Only items in Now and Next should be broken into epics in your issue tracker. Later stays in the roadmap doc to signal direction.
Create in your team's shared documentation tool (Confluence, Notion, Google Docs, etc.):
# Q[N] YYYY Roadmap — [Team Name]
## Strategy Alignment
How this quarter's work connects to company OKRs.
## Themes
1. Theme A — why this matters
2. Theme B — why this matters
## Committed Initiatives
| Initiative | Theme | Owner | Outcome | Effort | Dependencies |
|-----------|-------|-------|---------|--------|-------------|
| ... | ... | ... | ... | ... | ... |
## Stretch / Aspirational
Initiatives we'd take on if capacity allows.
## What We're NOT Doing (and Why)
Explicitly list deprioritized requests and the reasoning.
## Risks and Dependencies
| Risk | Mitigation | Owner |
|------|-----------|-------|
## Capacity Allocation
Pie chart or table showing planned split.
When presenting to leadership:
| Anti-Pattern | Why It's Bad | Better Approach | |-------------|-------------|----------------| | Overcommitting | Everything is "committed" with no slack | Leave 15–20% unplanned capacity | | Feature factory | Roadmap is a list of features with no outcomes | Every item must have a measurable outcome | | Planning in isolation | No input from team members on effort or feasibility | Include ICs in estimation and trade-off discussions | | All or nothing | Only big bets, no quick wins | Mix initiative sizes for momentum and morale | | Ignoring tech debt | Debt compounds silently until it explodes | Allocate 15–20% deliberately per cycle | | Roadmap as contract | Treating roadmap as immutable promise | Review and adjust monthly; communicate changes |
| Frequency | Activity | |-----------|----------| | Weekly | Check initiative progress against plan in standup or status update | | Monthly | Review roadmap health — are we on track? Any re-prioritization needed? | | Quarterly | Full roadmap refresh — score last quarter, plan next quarter | | Annually | Strategic planning — set themes and direction for the year |
development
TypeScript coding standards and type safety conventions. Use when: creating TypeScript files, defining interfaces and types, writing type-safe code, reviewing TypeScript for type correctness, auditing a codebase for type safety gaps, eliminating any or ts-ignore usage, or improving strict-mode compliance. Covers strict typing, avoiding any and ts-ignore, discriminated unions, Zod runtime validation, immutability patterns, and proper type definitions.
testing
Writing clear, actionable tickets in any issue tracker (Jira, Linear, GitHub Issues, ServiceNow, etc.). Use when: creating epics, stories, tasks, bugs, or spikes; writing acceptance criteria; decomposing work for a sprint; linking dependencies between tickets; auditing backlog items for clarity; or coaching a team on ticket quality. Covers title conventions, description templates, acceptance criteria, decomposition rules, dependency linking, and org-specific pluggable configuration.
development
Testing strategy, patterns, and evaluation for software and LLM/AI systems. Use when: writing tests, choosing test boundaries, designing test data, structuring test suites, evaluating LLM outputs, building evaluation pipelines, setting coverage thresholds, auditing test coverage gaps in existing projects, or improving test quality and structure.
development
Writing effective status updates for different audiences and cadences. Use when: writing a weekly status update, preparing a monthly summary, drafting a quarterly review, sending updates to leadership, sharing progress with stakeholders, or improving the clarity and impact of team communications. Covers weekly, monthly, and quarterly formats tailored for upward, lateral, and downward communication.