azure-enterprise-infra-planner

Azure エンタープライズインフラストラクチャプランナー

このスキルを使用するタイミング

ユーザーが次のことを希望する場合に、このスキルを有効にします。

• ワークロードやアーキテクチャの説明に基づいて、エンタープライズ向け Azure インフラストラクチャを計画する
• ランディングゾーン、ハブスポークネットワーク、またはマルチリージョントポロジーを設計する
• ネットワークインフラストラクチャ（VNet、サブネット、ファイアウォール、プライベートエンドポイント、VPN ゲートウェイ）を設計する
• ID、RBAC、コンプライアンス要件に基づくインフラストラクチャを計画する
• サブスクリプションスコープまたは複数のリソースグループにまたがるデプロイ向けに Bicep または Terraform を生成する
• ディザスターリカバリー、フェールオーバー、またはリージョン間の高可用性トポロジーを計画する

クイックリファレンス

プロパティ	詳細
MCP ツール	insights_get、get_azure_bestpractices_get、wellarchitectedframework_serviceguide_get、microsoft_docs_fetch、microsoft_docs_search、bicepschema_get
CLI コマンド	az deployment group create、az bicep build、az resource list、terraform init、terraform plan、terraform validate、terraform apply、checkov
出力スキーマ	schema.md
主なリファレンス	workflow.md、waf-checklist.md、resources/、constraints/

ワークフロー（ここから開始）

workflow.md の手順に従って、インフラストラクチャの計画とプロビジョニングを7つのフェーズで実行します。

アーキテクチャ

このスキルは7フェーズのゲート付きパイプラインを実行します。入力は次の2つのフローのいずれかに振り分けられます。

• グリーンフィールド — 新しい要件のみの場合は、各フェーズを順に実行します。
• 既存環境参照（ブラウンフィールド） — ユーザーがすでに存在するもの（稼働中のリソース／ リソースグループ／サブスクリプション、IaC またはインフラストラクチャ計画、あるいは要件ドキュメント）を提示する場合です。同じフェーズを実行し、さらに referenced-workload.md に従います。既存のリソースをインベントリ化して参照し （再作成はしません）、新しいワークロードをそれらに接続します。また、フェーズ7では追加のみのデプロイを実行します （増分のみで、参照対象のリソースは変更も破棄もしません）。

各フェーズは、そのゲートを通過した後にのみ進行します。フェーズ5ではユーザーによる明示的な承認が必要です。フェーズ6は、セキュリティを強化した自己検証ゲートです。生成された IaC はセキュアな既定値を備え、ローカル検証 （az bicep build／terraform validate）をエラーゼロで通過し、未解決の重大または高リスクの指摘がない状態で checkov セキュリティスキャンを通過する必要があります。また、スキルはコマンドの出力を表示し、完了時の自己チェックを出力してから次に進む必要があります。フェーズ7では、リスクを認識したうえでの明示的なデプロイ確認が必要です。

flowchart TD
    IN([Input]) --> TRIAGE{Existing infra<br/>referenced?}
    TRIAGE -- "No (greenfield)" --> P1
    TRIAGE -- "Yes (referenced)" --> RW[/referenced-workload.md:<br/>inventory + assign roles<br/>reference, never recreate/]
    RW --> P1

    subgraph PIPE [7-phase gated pipeline]
        direction TB
        P1[Phase 1 · Extract insights] --> P2[Phase 2 · Research best practices]
        P2 --> P3[Phase 3 · Research resources]
        P3 --> P4[Phase 4 · Generate plan]
        P4 --> P5{Phase 5 · Verify<br/>user approves?}
        P5 -- "no" --> P4
        P5 -- "approved" --> P6[Phase 6 · Generate IaC]
        P6 --> VAL{Validate<br/>az bicep build /<br/>terraform validate}
        VAL -- "errors" --> P6
        VAL -- "clean" --> P7{Phase 7 · Deploy<br/>risk-ack confirm?}
    end

    P7 -- "greenfield" --> DEP[az deployment / terraform apply]
    P7 -- "referenced" --> DEPADD[Additive deploy · incremental only<br/>what-if preview · no destroy of<br/>referenced resources]
    DEP --> OUT([Deployed])
    DEPADD --> OUT

    classDef gate fill:#fff3cd,stroke:#d39e00,color:#000;
    classDef ref fill:#e2f0d9,stroke:#548235,color:#000;
    class P5,VAL,P7,TRIAGE gate;
    class RW,DEPADD ref;

成果物（<project-root>/ の下に書き込まれます）：.azure/insights.json（フェーズ1）、 .azure/infrastructure-plan.json（フェーズ4、ステータスは draft→approved→deployed）、および infra/main.bicep + infra/modules/* または infra/main.tf + infra/modules/**（フェーズ6）。

MCP ツール

ツール	目的
insights_get	計画の決定に役立てるため、ユーザーの既存の Azure 環境に関する分析情報を取得します
get_azure_bestpractices_get	コード生成、運用、デプロイに関する Azure のベストプラクティス
wellarchitectedframework_serviceguide_get	特定の Azure サービス向けの WAF サービスガイド
microsoft_docs_search	関連するドキュメントのチャンクを Microsoft Learn で検索します
microsoft_docs_fetch	URL で指定された Microsoft Learn ページの全内容を取得します
bicepschema_get	あらゆる Azure リソースタイプの Bicep スキーマ定義（最新の API バージョン）

エラー処理

エラー	原因	解決方法
MCP ツールのエラーまたは利用不可	ツール呼び出しのタイムアウト、接続エラー、またはツールが存在しない	1 回再試行し、解決しない場合はリファレンスファイルを使用し、ユーザーに通知します
プランの承認がない	meta.status が approved ではない	IaC の生成またはデプロイの前に作業を停止し、ユーザーに承認を求めます
IaC の検証失敗	az bicep build または terraform validate がエラーを返す	生成されたコードを修正して再検証し、解決しない場合はユーザーに通知します
ペアリング制約違反	SKU またはリソースの組み合わせに互換性がない	IaC の生成に進む前にプランを修正します
インフラプランまたは IaC ファイルが見つからない	ファイルが誤った場所に書き込まれた、または作成されていない	ファイルが <project-root>/.azure/ と <project-root>/infra/ に存在することを確認します。存在しない場合は、workflow.md に厳密に従ってファイルを再作成します