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