mcpField
A
adr-roadmap

adr-roadmap

github.com/vladm3105開発1765 回インストール1 日前に更新
リポジトリ

adr-roadmap について

複数のアーキテクチャ決定記録（ADR）を調整するチーム向けの計画スキルです。既存の決定を変えずに、依存関係、工数、期間、リスク、テスト方針を含む段階的なロードマップを作成します。

主な機能

  1. 01ADR を棚卸しし依存参照を確認
  2. 02依存関係を図式化しクリティカルパスを算出
  3. 03工数を見積もり高リスク項目を特定
  4. 04依存関係に沿ってフェーズを編成
  5. 05マイルストーン付きタイムラインを作成
  6. 06リスク、テスト、技術的負債の方針を記録

活用シーン

  1. 01複数 ADR の実装計画を調整
  2. 02関係者にフェーズと期間を提示
  3. 03移行時のロールバックと並行稼働を計画
  4. 04アーキテクチャ決定に基づいて作業を順序付け

インストール

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

$npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill adr-roadmap

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

詳細

adr-roadmap

目的

プロジェクトのアーキテクチャ決定記録（ADR、第 5 層）を分析し、段階的な実装ロードマップを作成します。依存関係のマッピング、クリティカルパス、フェーズへの分割、期間の見積もり、フェーズごとのリスク評価、テスト戦略と技術的負債への対策を含みます。エンジンに依存せず、あらゆるドメイン（Web、モバイル、データ、ML、インフラストラクチャ、組み込み）で使用できます。

上流：ADR。下流：SPEC → TDD → IPLAN の提供順序に反映されます。

使用するタイミング

次の場合に adr-roadmap を使用します。

  • プロジェクトにおよそ 5 件以上の ADR があり、連携した段階的な展開が必要な場合。
  • アーキテクチャの依存関係とクリティカルパスを可視化する必要がある場合。
  • ADR の複雑さに基づくスケジュール、マイルストーン、エグゼクティブサマリーを関係者が必要としている場合。

単一の ADR で実装が単純な場合、実装作業を伴わない情報提供のみの ADR の場合、要件から計画を立てる場合（../doc-brd/SKILL.md / ../doc-prd/SKILL.md / ../doc-ears/SKILL.md を使用）、または図だけが必要な場合（../charts-flow/SKILL.md を使用）は、使用しないでください。

動作

  1. ADR を一覧化する — すべての ADR-*.md を読み込み、ID、タイトル、ステータス、複雑度（1～5）、工数、依存関係を抽出します。複雑度の記載漏れや依存関係の参照切れがあれば警告し、ADR が見つからない場合はエラーにします。
  2. 依存関係グラフを作成する — 強い依存関係／弱い依存関係／依存関係なしに分類し、循環を検出して（エラー）、クリティカルパスを計算し、並行して進められるクラスターを特定します。
  3. 工数を見積もる — 複雑度を基準工数に対応付け、ADR 全体の工数を合計し、リスクバッファー（約 20％）を適用して、リスクの高い ADR（複雑度 4～5 で依存関係が多いもの）を明示します。
  4. フェーズを編成する — 選択したフェーズモデル（デフォルトは poc-mvp-prod、または iterative、waterfall）を適用し、依存関係を守り、フェーズの長さに上限（デフォルトは 8 週間）を設け、リスクを分離し、自然なマイルストーンでフェーズを終了します。グリーンフィールド、ブラウンフィールド／移行（ロールバックとデュアルランを追加）、またはリファクタリング（モジュール単位）プロジェクトに合わせて調整します。
  5. スケジュールを作成する — 工数とチーム規模からフェーズ期間を算出し、フェーズ間にバッファーを追加して、マイルストーン付きのガントチャート（../charts-flow/SKILL.md 経由）を作成します。
  6. ロードマップを作成する — {adr_dir}/ADR-00_IMPLEMENTATION-ROADMAP.md に作成します。文書管理情報、エグゼクティブサマリー、フェーズごとのセクション（目標、ADR、アーキテクチャ図、順序、成果物、成功／終了基準、リスク）、依存関係マトリクス、技術的負債の管理、リスク評価、テスト戦略、上流（BRD–BDD）および下流（SPEC/TDD/IPLAN）の成果物へのトレーサビリティを記載します。

制約：ADR の決定をそのまま使用し（技術選定は行いません）、すべての ADR を必ずいずれか 1 つのフェーズに割り当て、フェーズの上限を超えず、客観的な表現を保ちます。本番フェーズにはロールバック計画を必須とします。各ドキュメントは 100k トークン未満にしてください。

関連リソース

  • ADR レイヤー：${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/README.md · ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/ADR-TEMPLATE.yaml
  • ID とタグの標準：${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md
  • トレーサビリティ：${CLAUDE_PLUGIN_ROOT}/framework/governance/TRACEABILITY.md
  • 図：../charts-flow/SKILL.md
  • 下流の生成：../doc-spec/SKILL.md · ../doc-tdd/SKILL.md · ../doc-iplan/SKILL.md
  • トレーサビリティチェック：../doc-validator/SKILL.md

コメント

Markdown 対応