mcpField
R
roadmap-review

roadmap-review

github.com/frostney開発078 回インストール3 日前に更新
リポジトリ

roadmap-review について

roadmap-reviewは、プロジェクト計画担当者向けに、根拠を確認したロードマップとリリース計画を作成するスキルです。現時点の情報と実測スループットに基づいて計画し、確認を得てからプロジェクト記録を変更します。

主な機能

  1. 01最新のプロジェクト情報を検証
  2. 02マージ量とリードタイムを測定
  3. 03現行コードに照らして作業を分類
  4. 04依存関係を踏まえてリリースを計画
  5. 05確認後にプロジェクト記録を変更

活用シーン

  1. 01リリース頻度と計画のずれを評価
  2. 02残作業量に基づくリリース計画
  3. 03人の判断が必要な事項を特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/frostney/known-good-route --skill roadmap-review

インストール後、Claude Code で/roadmap-reviewを入力して読み込まれたか確認します。

詳細

ロードマップレビュー

ソースで検証したロードマップと、スループットに基づくリリース計画を作成します。成果物は分析です。イシュー、プルリクエスト、マイルストーン、リリースの変更は任意であり、確認を得た場合にのみ実施します。

エビデンスに関する取り決め

  • 今回の実行時に、最新のイシュー、リリース、マイルストーン、マージ済み PR の履歴、プロジェクトの方向性を示すドキュメントを取得します。見つからないソースは記録し、記憶で補わずに確信度を下げます。
  • 過去 90 日間のマージ済み PR のスループットと、イシュー作成から PR マージまでのリードタイムを測定します。PR オープンからマージまでの期間は、フォールバックとして明示した場合に限り使用します。実装に至っていないクローズ済みのトリアージは除外します。
  • ドメイン指標がある場合は、間隔を空けた過去の CI 成果物からその推移を測定します。ラベルや領域別の配分は、過去の取り組みを示すものであり、キャパシティを示すものではありません。
  • 作業を提案または評価する前に、現行コード、テスト、または一次仕様に照らして、完了、一部完了、未着手のいずれかに分類し、根拠を示します。一部完了または未着手の作業のみを提案します。

ホストが対応している場合、独立した重要なエビデンス領域は、コンテキストを分離したサブエージェントに委任することを原則とします。小規模な領域や相互に関連する領域は直接扱います。計画を立てる前に結果を統合します。

ワークフロー

  1. エビデンスに関する取り決めに基づいてレビューを行い、Git ホスティングサービス上のイシュー、プルリクエスト、リリース、マイルストーンの件数を照合します。
  2. リリースの頻度、マージ済みだが未リリースの作業、マイルストーンとコミットのずれ、ビジョン、対象範囲、対象外事項を評価します。
  3. すべての候補をエビデンスに関する取り決めに従って分類し、すでに提供済みの作業を除外します。
  4. 測定した速度を、件数を確認した残存バックログに適用し、その根拠と確信度を示します。スケジュールを水増ししてはいけません。エビデンスで暦日を裏付けられない場合は、日付入りのガントチャートや仮の日付を示さず、期間の範囲と依存関係を報告します。
  5. 独立した複数のトラックにまたがるテーマ別リリースを計画し、依存関係と最長所要工程を明示します。実際に人の判断が必要な事項は、推奨案とともに示します。
  6. それらの判断事項で作業を止め、以下を提示します。
    • 現状、ずれ、リリース頻度に関する推奨事項
    • 測定したベロシティと確信度
    • バージョンと規模を示したトラック
    • スループットに基づくタイムライン(可能な場合は Mermaid のガントチャートを含む)
    • 未決事項
  7. 日付入りの ROADMAP-YYMMDD.md を作成する選択肢を提示します。ユーザーから依頼されない限り、書き込みは行いません。
  8. 最終計画について明示的な確認を得た後に限り、マイルストーン、イシュー、期限、ラベルを作成または変更します。各イシューは /create-issue を通じて作成し、変更内容を正確に報告します。
  9. 確認済みのマイルストーンと追跡対象の範囲が確定した後、次のアクションとして /milestone-rush <milestone> を提示します。ラッシュを自動的に開始してはいけません。これを選択すると、そのスキルに定められた範囲内での実装権限とマージ権限が付与されます。

レポートは意思決定に役立つ内容に絞り、スナップショットの日付を記載します。古いレポートに基づいて行動する前に、情報を再取得します。

コメント