roadmap-communicator

ロードマップのコミュニケーション

社内外のステークホルダー向けに、明確なロードマップ関連資料を作成します。

使用する場面

以下の場合にこのスキルを使用します。

• さまざまな形式のロードマッププレゼンテーションを作成する
• ステークホルダー向けの更新情報を作成する（取締役会、エンジニアリング、顧客）
• リリースノートを作成する（ユーザー向けおよび社内向け）
• git の履歴から変更履歴を生成する
• 機能の発表内容を構成する

ロードマップの形式

1. 今／次／後で

• 不確実性への対応と戦略上の柔軟性を重視する場合に最適です。
• 過度に正確な印象を与えずに、方向性を伝えます。

2. タイムライン形式のロードマップ

• 日付が確定したコミットメントやローンチの調整に最適です。
• リスクと依存関係を積極的に管理する必要があります。

3. テーマ別ロードマップ

• 成果を重視した計画やチーム間の連携に最適です。
• 問題領域や戦略目標ごとに取り組みをまとめます。

テンプレートについては、references/roadmap-templates.md を参照してください。

ステークホルダー向け更新パターン

取締役会／経営幹部

• 成果とリスクを重視します
• 戦略目標に対する進捗に焦点を当てます
• トレードオフと必要な意思決定を明確にします

エンジニアリング

• スコープ、依存関係、順序を明確にします
• ステータス、ブロッカー、リソースへの影響を示します

顧客

• 価値に関する説明と時期の目安を示します
• 現在利用可能なものと今後予定されているものを明確にします
• 明確な期待値を設定します

再利用可能なテンプレートについては、references/communication-templates.md を参照してください。

リリースノートのガイダンス

ユーザー向けリリースノート

• 内部実装の詳細ではなく、ユーザーにとっての価値から説明を始めます。
• ワークフローやユーザーのタスクごとにまとめます。
• 移行や動作の変更を明記します。

社内向けリリースノート

• 技術的な詳細、運用への影響、既知の問題を記載します。
• 展開計画、ロールバックの基準、監視に関するメモを記録します。

変更履歴の生成

以下を使用します。

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

機能：

• git のログ範囲を読み取ります
• Conventional Commits のプレフィックスを解析します
• エントリーを種類（feat、fix、chore など）ごとに分類します
• Markdown またはプレーンテキストで出力します

機能発表のフレームワーク

1. 問題の背景
2. 変更内容
3. 重要である理由
4. 主な対象者
5. 利用開始方法
6. 行動喚起とフィードバック窓口

コミュニケーション品質チェックリスト

• 対象者に合わせた説明が明確です。
• 成果とトレードオフが明確です。
• 用語が資料全体で統一されています。
• リスクや依存関係を隠していません。
• 次のアクションと担当者が明記されています。