borghei/roadmap-communicator
> 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.
npx skills add https://github.com/borghei/Claude-Skills --skill 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).
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.
roadmap_audience_translator.py with target audience.python3 roadmap-communicator/scripts/roadmap_audience_translator.py \
--input roadmap.json --audience customer --format markdown
confidence_band_generator.py with team velocity history + estimation context.python3 roadmap-communicator/scripts/confidence_band_generator.py \
--input items.json --format markdown
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
| 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.
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:
A useful skeleton across audiences:
This protects confidence: the closer in time, the firmer the commitment.
Communicate at the right granularity:
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.
references/roadmap-communication-patterns.md — format catalog + when to usereferences/audience-specific-formats.md — per-audience templatesreferences/now-next-later-and-themes.md — structural patternsproduct-team/product-strategist — strategy upstream of roadmapproduct-team/agile-product-owner — sprint-level executionproduct-team/product-manager-toolkit — broader PM toolingc-level-advisor/cpo-advisor — CPO partnershipc-level-advisor/ceo-advisor — CEO / board alignmentbusiness-growth/customer-success-manager — customer commsmarketing/ skills — external messaging alignmentTake borghei/roadmap-communicator from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.