Skill Instructions

Goal

Generate a new, human-maintainable set of .bicep files plus a .bicepparam file that deploys Azure infrastructure based on user requirements.

Guiding Principles

• •Optimize for maintainability and clarity: split into sensible modules, use descriptive names, and factor repeated patterns.
• •Prefer templates that look like they were written by a human, not auto-generated code.
• •Always start with example infrastructure and planning before generating resource configurations.

Required Tools / Commands

Strongly prefer the following tools/commands as part of the workflow, instead of finding other tools or CLI commands to call:

• •generate_infrastructure_plan MCP tool: gather comprehensive requirements and generate a detailed architecture design.
• •generate_resource_body MCP tool: get properly configured resource definitions with security best practices applied.
• •get_bicep_best_practices MCP tool: learn current best practices before generating templates.
• •get_bicep_file_diagnostics MCP tool: compile/validate Bicep and address errors/warnings after generating files.
• •what_if_deployment MCP tool: run a live diff against Azure using a .bicepparam file.

Workflow

1) Plan the Architecture

• •Gather comprehensive requirements using the generate_infrastructure_plan MCP tool.
• •This returns:
  • •Overview of the infrastructure design
  • •Complete list of required resources with types and API versions
  • •Resource relationships and dependencies
  • •Security and configuration requirements
• •Explain the proposed architecture to the user before proceeding.

2) Generate Resource Configurations

• •For each resource in the plan, use the generate_resource_body MCP tool to get properly configured resource definitions.
• •This returns complete resource body JSON with security best practices applied.
• •Ensure all resources from the plan are accounted for.

3) Create the Bicep Files

• •Generate complete .bicep and .bicepparam files including:
  • •Parameters with @description annotations for configurable values
  • •Variables for computed values
  • •Resources converted from JSON to Bicep syntax
  • •Proper resource dependencies using Bicep references
  • •Outputs for important resource properties (IDs, endpoints, URLs)
  • •Comments documenting configuration decisions
• •Use a main entrypoint (for example main.bicep) and split resources into modules by domain if the infrastructure is complex.
• •Declare parameter values in the .bicepparam file, rather than using default values in the .bicep file parameter declarations.

4) Offline validation

• •After generating files, run get_bicep_file_diagnostics on the .bicep files.
• •Fix compilation errors immediately.
• •Review warnings and fix anything that could affect correctness, deployment behavior, or maintainability.

5) Live validation

• •Run what_if_deployment on the .bicepparam file.
• •Make sure you know which subscriptionId and resourceGroup to use before calling this tool - ask the user for input if you don't have this context.
• •Verify the output matches your expectations.

Acceptance Criteria

• •A coherent set of .bicep files + a .bicepparam file exists for the requested infrastructure.
• •The Bicep compiles cleanly (diagnostics show no errors; warnings are understood/acceptable).
• •All resources from the infrastructure plan are included.
• •Security best practices from the generated resource bodies are applied.