Roadmap Communicator
A skill focused on communicating the roadmap — different audiences
need different formats and confidence levels. Distinct from product-strategist
(which builds the strategy) and agile-product-owner (which manages sprint
execution).
When to use this skill
- Preparing a roadmap readout for execs, board, customers, or sales
- Translating a single internal roadmap to multiple audience formats
- Auditing roadmap commitments for over-promise risk
- Building a now-next-later view of priorities
- Communicating roadmap changes to stakeholders
- Preparing a what-changed/what's-next memo
Inputs the advisor expects
- The internal roadmap (themes, initiatives, target dates, confidence)
- Target audience(s) for the communication
- Recent roadmap changes (added, removed, slipped)
- Cross-functional commitments (engineering, sales, marketing)
Clarify First
Before generating the roadmap communication, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Workflows
Workflow 1 — Translate roadmap for a specific audience
- Capture the master roadmap with confidence bands.
- Run
roadmap_audience_translator.py with target audience.
- Review the audience-specific output; tune language.
python3 roadmap-communicator/scripts/roadmap_audience_translator.py \
--input roadmap.json --audience customer --format markdown
Workflow 2 — Apply confidence bands to commitments
- List proposed roadmap items.
- Run
confidence_band_generator.py with team velocity history + estimation context.
- Adjust item commitments based on output (commit / aspire / explore).
python3 roadmap-communicator/scripts/confidence_band_generator.py \
--input items.json --format markdown
Workflow 3 — Generate a roadmap diff report
- Capture previous roadmap snapshot + current roadmap.
- Run
roadmap_diff_reporter.py to produce what-changed memo.
python3 roadmap-communicator/scripts/roadmap_diff_reporter.py \
--previous roadmap_q1.json --current roadmap_q2.json --format markdown
Decision frameworks
Audience-format matrix
| Audience |
Right format |
Wrong format |
| Board / exec |
Themes + bets + KPIs (1 page) |
Feature list |
| Customers / public |
What's new + what's next (themes; no dates) |
Internal commit list |
| Sales |
Themes + competitive positioning + customer-ask coverage |
Engineering jargon |
| Engineering |
Themes + quarter commitments + scoped detail |
Vague aspirations |
| Internal company |
Themes + progress + asks |
Confidential strategy |
| Partner / integrator |
API-relevant changes + breaking-change calendar |
All-up roadmap |
Same roadmap; different formats. Don't send the engineering commit list to customers.
Confidence bands
Apply per item:
| Band |
Language |
Audience expectation |
| Commit |
"Will ship" with target date |
Hold us to this |
| Plan |
"Plan to ship" with target window |
Confident but conditional |
| Aspire |
"Investigating" / "Exploring" |
Don't depend on this |
| Strategic intent |
"We believe X matters" |
Direction, not deliverable |
Common errors:
- Treating "plan" as "commit" — sets up disappointment
- Communicating "commit" as "plan" — under-delivers excitement
- No confidence band — every line read as commit
Now-next-later structure
A useful skeleton across audiences:
- Now (in progress, < 1 quarter): commit-level items
- Next (1-2 quarters out): plan-level items
- Later (2-4 quarters): aspire-level items
- Strategic intent (>4 quarters): direction only
This protects confidence: the closer in time, the firmer the commitment.
Themes vs features
Communicate at the right granularity:
- External / strategic: themes ("better collaboration")
- Customer-specific: outcomes ("you'll be able to X")
- Internal: features + tickets
Telling a customer "we're adding X in Q3" makes a commitment that may
not be precise enough. Telling the team "we're going to improve
collaboration somehow" is too vague.
Common engagements
"Help me write the customer roadmap section"
- Start with what they care about (outcomes, not features).
- Use themes + outcomes; avoid specific dates beyond the current quarter.
- Group: launching soon, in development, exploring.
- Avoid: features that depend on uncertain technical bets.
- Always include a "we'd love your input" hook.
"Help me prep the board roadmap section"
- Start with strategic themes (3-5).
- For each theme: what's shipped, what's coming, what's the bet.
- Tie to business outcomes (NRR impact, new revenue, cost saving).
- Surface 1-2 strategic risks transparently.
- End with 2-3 specific asks.
"Our customer is asking 'when will X ship?'"
- First check: is X actually committed? (Probably plan or aspire.)
- If commit: give a target window with caveats.
- If plan: "We're planning to ship in [window]; we'll know more by [date]."
- If aspire: "We're exploring; not in our committed roadmap."
- Document the customer asks; feed them back into prioritization.
Anti-patterns to avoid
- One-size-fits-all roadmap. Different audiences get over- or under-served.
- Date-only roadmap. Dates without confidence bands set up over-promise.
- Public commitments engineering didn't sign off on. Trust breaks.
- Roadmap that never changes. Reality changes; roadmap must.
- Roadmap silence between updates. Customers / sales speculate.
- Hiding strategic risks. Boards prefer honest risks over surprise misses.
- Big bang annual roadmap with no quarterly delta. Misses change cycles.
- Feature names instead of outcomes. "Notifications v2" tells the customer nothing.
References
references/roadmap-communication-patterns.md — format catalog + when to use
references/audience-specific-formats.md — per-audience templates
references/now-next-later-and-themes.md — structural patterns
Related skills
product-team/product-strategist — strategy upstream of roadmap
product-team/agile-product-owner — sprint-level execution
product-team/product-manager-toolkit — broader PM tooling
c-level-advisor/cpo-advisor — CPO partnership
c-level-advisor/ceo-advisor — CEO / board alignment
business-growth/customer-success-manager — customer comms
marketing/ skills — external messaging alignment
1---2name: roadmap-communicator3description: Translate one internal roadmap into audience-appropriate formats with confidence-band discipline. Use when preparing a roadmap readout, tailoring it for an exec, customer, eng, or sales audience, or auditing over-promise risk.4license: MIT + Commons Clause5---6
7# Roadmap Communicator
8
9A skill focused on **communicating the roadmap** — different audiences
10need different formats and confidence levels. Distinct from `product-strategist`
11(which builds the strategy) and `agile-product-owner` (which manages sprint
12execution).
13
14## When to use this skill
15
16- Preparing a **roadmap readout** for execs, board, customers, or sales
17- Translating a single internal roadmap to multiple audience formats
18- Auditing **roadmap commitments** for over-promise risk
19- Building a **now-next-later** view of priorities
20- Communicating **roadmap changes** to stakeholders
21- Preparing a **what-changed/what's-next** memo
22
23## Inputs the advisor expects
24
25- The internal roadmap (themes, initiatives, target dates, confidence)
26- Target audience(s) for the communication
27- Recent roadmap changes (added, removed, slipped)
28- Cross-functional commitments (engineering, sales, marketing)
29
30## Clarify First
31
32Before generating the roadmap communication, confirm these inputs. If any is unknown or vague, ASK — do not assume:
33
34- [ ] **Target audience** — board/exec, customer, sales, or engineering (selects the audience-format matrix row and granularity)
35- [ ] **Confidence band per item** — commit, plan, aspire, or strategic intent (drives the language and over-promise guardrails)
36- [ ] **Recent changes** — what was added, removed, or slipped since the last readout (drives the what-changed diff memo)
37
38Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
39
40## Workflows
41
42### Workflow 1 — Translate roadmap for a specific audience
43
441. Capture the master roadmap with confidence bands.
452. Run `roadmap_audience_translator.py` with target audience.
463. Review the audience-specific output; tune language.
47
48```bash
49python3 roadmap-communicator/scripts/roadmap_audience_translator.py \
50 --input roadmap.json --audience customer --format markdown
51```
52
53### Workflow 2 — Apply confidence bands to commitments
54
551. List proposed roadmap items.
562. Run `confidence_band_generator.py` with team velocity history + estimation context.
573. Adjust item commitments based on output (commit / aspire / explore).
58
59```bash
60python3 roadmap-communicator/scripts/confidence_band_generator.py \
61 --input items.json --format markdown
62```
63
64### Workflow 3 — Generate a roadmap diff report
65
661. Capture previous roadmap snapshot + current roadmap.
672. Run `roadmap_diff_reporter.py` to produce what-changed memo.
68
69```bash
70python3 roadmap-communicator/scripts/roadmap_diff_reporter.py \
71 --previous roadmap_q1.json --current roadmap_q2.json --format markdown
72```
73
74## Decision frameworks
75
76### Audience-format matrix
77
78| Audience | Right format | Wrong format |
79|----------|--------------|--------------|
80| Board / exec | Themes + bets + KPIs (1 page) | Feature list |
81| Customers / public | What's new + what's next (themes; no dates) | Internal commit list |
82| Sales | Themes + competitive positioning + customer-ask coverage | Engineering jargon |
83| Engineering | Themes + quarter commitments + scoped detail | Vague aspirations |
84| Internal company | Themes + progress + asks | Confidential strategy |
85| Partner / integrator | API-relevant changes + breaking-change calendar | All-up roadmap |
86
87Same roadmap; different formats. Don't send the engineering commit list to customers.
88
89### Confidence bands
90
91Apply per item:
92
93| Band | Language | Audience expectation |
94|------|----------|----------------------|
95| **Commit** | "Will ship" with target date | Hold us to this |
96| **Plan** | "Plan to ship" with target window | Confident but conditional |
97| **Aspire** | "Investigating" / "Exploring" | Don't depend on this |
98| **Strategic intent** | "We believe X matters" | Direction, not deliverable |
99
100Common errors:
101- Treating "plan" as "commit" — sets up disappointment
102- Communicating "commit" as "plan" — under-delivers excitement
103- No confidence band — every line read as commit
104
105### Now-next-later structure
106
107A useful skeleton across audiences:
108
109- **Now** (in progress, < 1 quarter): commit-level items
110- **Next** (1-2 quarters out): plan-level items
111- **Later** (2-4 quarters): aspire-level items
112- **Strategic intent** (>4 quarters): direction only
113
114This protects confidence: the closer in time, the firmer the commitment.
115
116### Themes vs features
117
118Communicate at the right granularity:
119
120- **External / strategic:** themes ("better collaboration")
121- **Customer-specific:** outcomes ("you'll be able to X")
122- **Internal:** features + tickets
123
124Telling a customer "we're adding X in Q3" makes a commitment that may
125not be precise enough. Telling the team "we're going to improve
126collaboration somehow" is too vague.
127
128## Common engagements
129
130### "Help me write the customer roadmap section"
1311. Start with what they care about (outcomes, not features).
1322. Use themes + outcomes; avoid specific dates beyond the current quarter.
1333. Group: launching soon, in development, exploring.
1344. Avoid: features that depend on uncertain technical bets.
1355. Always include a "we'd love your input" hook.
136
137### "Help me prep the board roadmap section"
1381. Start with strategic themes (3-5).
1392. For each theme: what's shipped, what's coming, what's the bet.
1403. Tie to business outcomes (NRR impact, new revenue, cost saving).
1414. Surface 1-2 strategic risks transparently.
1425. End with 2-3 specific asks.
143
144### "Our customer is asking 'when will X ship?'"
1451. First check: is X actually committed? (Probably plan or aspire.)
1462. If commit: give a target window with caveats.
1473. If plan: "We're planning to ship in [window]; we'll know more by [date]."
1484. If aspire: "We're exploring; not in our committed roadmap."
1495. Document the customer asks; feed them back into prioritization.
150
151## Anti-patterns to avoid
152
153- **One-size-fits-all roadmap.** Different audiences get over- or under-served.
154- **Date-only roadmap.** Dates without confidence bands set up over-promise.
155- **Public commitments engineering didn't sign off on.** Trust breaks.
156- **Roadmap that never changes.** Reality changes; roadmap must.
157- **Roadmap silence between updates.** Customers / sales speculate.
158- **Hiding strategic risks.** Boards prefer honest risks over surprise misses.
159- **Big bang annual roadmap with no quarterly delta.** Misses change cycles.
160- **Feature names instead of outcomes.** "Notifications v2" tells the customer nothing.
161
162## References
163
164- `references/roadmap-communication-patterns.md` — format catalog + when to use
165- `references/audience-specific-formats.md` — per-audience templates
166- `references/now-next-later-and-themes.md` — structural patterns
167
168## Related skills
169
170- `product-team/product-strategist` — strategy upstream of roadmap
171- `product-team/agile-product-owner` — sprint-level execution
172- `product-team/product-manager-toolkit` — broader PM tooling
173- `c-level-advisor/cpo-advisor` — CPO partnership
174- `c-level-advisor/ceo-advisor` — CEO / board alignment
175- `business-growth/customer-success-manager` — customer comms
176- `marketing/` skills — external messaging alignment