All skills
microsoft avatar

/azure-enterprise-infra-planner

@5f24d7e official

Architect and provision enterprise Azure infrastructure from workload descriptions. For cloud architects and platform engineers planning networking, identity, security, compliance, and multi-resource topologies with WAF alignment. Generates Bicep or Terraform directly (no azd). WHEN: 'plan Azure infrastructure', 'architect Azure landing zone', 'design hub-spoke network', 'plan multi-region DR topology', 'set up VNets firewalls and private endpoints', 'subscription-scope Bicep deployment', 'Azure Backup for VM workloads'. PREFER azure-prepare FOR app-centric workflows.

Use this Skill: https://skilld.dev/gh/microsoft/github-copilot-for-azure/azure-enterprise-infra-planner

This session only. Nothing lands on disk.

referencesverification.md

≈668 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Resource Verification

Run these checks immediately after writing each resource to plan.resources[]. Fix issues in-place before moving to the next resource. Load the relevant category file from resources/ for naming constraints, valid SKUs, and pairing rules.

1. Name Checks

# Check Fix
1 Follows CAF pattern from resource file Identity/Naming section Rewrite using correct abbreviation
2 Length within min/max for type Truncate or restructure
3 Only allowed characters for type Strip disallowed characters
4 Globally-unique names avoid collisions Add distinguishing suffix
5 Required subnet names exact (AzureFirewallSubnet, GatewaySubnet, AzureBastionSubnet) Use exact required string
6 Function Apps sharing Storage diverge within first 32 chars Rename or separate storage
7 AKS MC_{rg}_{cluster}_{region} ≤ 80 chars Shorten names

2. Dependency Checks

# Check Fix
1 Every dependencies entry references an existing resource name in the plan Add missing resource or remove stale ref
2 Implicit dependencies are explicit (subnet→VNet, App Service→Plan) Add missing entries
3 No circular dependencies Break weaker edge

3. Property & Pairing Checks

Read pairing-checks.md in full. It covers SKU compatibility, subnet/network conflicts, storage pairing, Cosmos DB, Key Vault/CMK, SQL Database, and AKS networking. For every connected pair of resources in the plan, walk through each applicable rule, confirm compliance, and fix any violation in-place before moving on to the next pair.

4. Insights Checks

Skip this section when insights.json does not exist or contains no insights.

# Check Fix
1 Every insight in insights.json is either justified in inputs.insightsApplied or has a documented reason for non-application in plan.overallReasoning.tradeoffs. An insight must not appear in both. Add the insight to insightsApplied or document why it was not followed.
2 Every entry in inputs.insightsApplied cites the insight ID correctly, and its description of how and why it was applied references the insight's pattern and planning implication. Correct the entry or remove it if it was applied incorrectly.
3 No insight should result in a weaker security posture than available alternatives, unless it is explicitly requested in the user prompt or stated in the sub-goals. Revert to the stronger alternative and move the insight to plan.overallReasoning.tradeoffs with an explanation.

Source: SKILL.md on GitHub

No alerts5mo4 checks · Risk SAFE
  • Gen Agent Trust Hub5mo

    This skill provides a comprehensive framework for planning and deploying Azure infrastructure using Bicep and Terraform. It leverages official Microsoft documentation and Azure CLI tools to ensure architectural alignment with the Well-Architected Framework. The skill includes built-in security practices such as managed identity usage, RBAC enforcement, and secure parameter handling.

  • Socket5mo

    No alerts

  • Snyk5mo

    Risk: LOW · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 5f24d7e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
metadata
{
  "author": "Microsoft",
  "version": "0.0.0-placeholder"
}
  • Infrastructure
  • azure
  • bicep
  • terraform
  • networking
  • landing-zone
  • hub-spoke
  • identity
  • disaster-recovery
  • compliance

README badge

README badge for microsoft/github-copilot-for-azure/azure-enterprise-infra-planner

Generates Bicep or Terraform code for enterprise Azure infrastructure from workload descriptions, covering networking, identity, security, and multi-region topologies aligned with Azure Well-Architected Framework. Targets cloud architects and platform engineers planning landing zones, hub-spoke networks, and subscription-scope deployments.

Generated from the current SKILL.md.

Does this skill generate Terraform or Bicep?
It generates both Bicep and Terraform directly. The skill targets subscription-scope and multi-resource-group deployments without using Azure Developer CLI (azd).
What Azure infrastructure patterns does this skill handle?
It covers enterprise patterns including landing zones, hub-spoke networks, multi-region disaster recovery, VNets, firewalls, private endpoints, VPN gateways, identity, RBAC, and compliance-driven topologies.
Should I use this skill for application-centric workflows?
No. The skill description explicitly recommends using azure-prepare instead for app-centric workflows. This skill is optimized for infrastructure and platform engineering.
Does this skill validate generated infrastructure code?
Yes. It includes validation for both Bicep (az bicep build) and Terraform (terraform validate) and checks for pairing constraint violations before deployment.
What MCP tools does this skill rely on?
It uses insights_get, get_azure_bestpractices_get, wellarchitectedframework_serviceguide_get, microsoft_docs_search, microsoft_docs_fetch, and bicepschema_get to fetch best practices, WAF guidance, and schema definitions.

Generated from the current SKILL.md. These answers refresh after source changes.