Roadmap Communicator

Stakeholder Update Patterns

Board / Executive

• Outcome and risk oriented
• Focus on progress against strategic goals
• Highlight trade-offs and required decisions

Engineering

• Scope, dependencies, and sequencing clarity
• Status, blockers, and resourcing implications

Customers

• Value narrative and timing window
• What is available now vs upcoming
• Clear expectation setting

See references/communication-templates.md for reusable templates.

Release Notes Guidance

User-Facing Release Notes

• Lead with user value, not internal implementation details.
• Group by workflows or user jobs.
• Include migration/behavior changes explicitly.

Internal Release Notes

• Include technical details, operational impact, and known issues.
• Capture rollout plan, rollback criteria, and monitoring notes.

Changelog Generation

Use:

python3 scripts/changelog_generator.py --from v1.0.0 --to HEAD

Features:

• Reads git log range
• Parses conventional commit prefixes
• Groups entries by type (feat, fix, chore, etc.)
• Outputs markdown or plain text

Feature Announcement Framework

1. Problem context
2. What changed
3. Why it matters
4. Who benefits most
5. How to get started
6. Call to action and feedback channel

Communication Quality Checklist

• Audience-specific framing is explicit.
• Outcomes and trade-offs are clear.
• Terminology is consistent across artifacts.
• Risks and dependencies are not hidden.
• Next actions and owners are specified.