Skip to content

Robertjam954/multimodal_rag_application / .claude/skills/azure-enterprise-infra-planner

azure-enterprise-infra-planner

Verified

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.

FileKindSize
SKILL.mdskill md3.5 KB
references/bicep-generation.mdmarkdown3.5 KB
references/constraints/README.mdmarkdown1.2 KB
references/constraints/ai-ml.mdmarkdown3.2 KB
references/constraints/compute-apps.mdmarkdown7.8 KB
references/constraints/compute-infra.mdmarkdown4.5 KB
references/constraints/data-analytics.mdmarkdown6.3 KB
references/constraints/data-relational.mdmarkdown4.9 KB
references/constraints/messaging.mdmarkdown2.5 KB
references/constraints/monitoring.mdmarkdown1.7 KB
references/constraints/networking-connectivity.mdmarkdown6.1 KB
references/constraints/networking-core.mdmarkdown7.0 KB
references/constraints/networking-traffic.mdmarkdown4.6 KB
references/constraints/security.mdmarkdown2.4 KB
references/deployment.mdmarkdown3.7 KB
references/pairing-checks.mdmarkdown3.7 KB
references/phases/1-extract-insights.mdmarkdown1.8 KB
references/phases/2-research-best-practices.mdmarkdown2.8 KB
references/phases/3-research-resources.mdmarkdown3.3 KB
references/phases/4-generate-plan.mdmarkdown792 B
references/phases/5-verify.mdmarkdown814 B
references/phases/6-generate-iac.mdmarkdown675 B
references/phases/7-deploy.mdmarkdown1.3 KB
references/resources/README.mdmarkdown1.6 KB
references/resources/ai-ml.mdmarkdown2.1 KB
references/resources/compute-apps.mdmarkdown4.0 KB
references/resources/compute-infra.mdmarkdown2.8 KB
references/resources/data-analytics.mdmarkdown3.0 KB
references/resources/data-relational.mdmarkdown2.6 KB
references/resources/messaging.mdmarkdown2.0 KB
references/resources/monitoring.mdmarkdown1.5 KB
references/resources/networking-connectivity.mdmarkdown3.6 KB
references/resources/networking-core.mdmarkdown4.3 KB
references/resources/networking-traffic.mdmarkdown2.6 KB
references/resources/security.mdmarkdown1.5 KB
references/schema.mdmarkdown2.7 KB
references/terraform-generation.mdmarkdown2.7 KB
references/verification.mdmarkdown2.6 KB
references/waf-checklist.mdmarkdown1.9 KB
references/workflow.mdmarkdown2.6 KB

references/bicep-generation.md

View on GitHub
# Bicep Generation

Generate Bicep IaC files from the approved infrastructure plan.

> Important: All Bicep files must be created under `<project-root>/infra/`. Never place `.bicep` files in the project root or in `.azure/`.

## File Structure

Generate files under `<project-root>/infra/`:

```
infra/
├── main.bicep              # Orchestrator — deploys all modules
├── main.bicepparam         # Parameter values
└── modules/
    ├── storage.bicep        # One module per resource or logical group
    ├── compute.bicep
    ├── networking.bicep
    └── monitoring.bicep
```

## Generation Steps

1. Create `infra/` directory — create `<project-root>/infra/` and `<project-root>/infra/modules/` directories. All files in subsequent steps go here.
2. Read plan — load `<project-root>/.azure/infrastructure-plan.json`, verify `meta.status === "approved"`
3. Fetch Bicep schemas — for each resource in the plan, use a sub-agent to call `bicepschema_get` with `resource-type` set to the ARM type from the relevant [resources/](resources/README.md) category file (e.g., `Microsoft.ContainerService/managedClusters`). Instruct the sub-agent: "Return the full property structure for {ARM type}: required properties, allowed values, child resources. ≤500 tokens." Use this output — not training data — to generate correct resource definitions.

> The schema tool returns only the schema for the exact type requested. Sub-resource types (e.g., `Microsoft.Network/virtualNetworks/subnets`) return a smaller, focused schema but miss parent-level properties (e.g., VNet `encryption` lives on the parent, not the subnet sub-resource). Strategy:
> - Start with sub-resource types when validating child resources — smaller responses (~25KB vs ~95KB), easier to summarize
> - Fetch the parent type separately when you need parent-level properties (encryption, tags, SKU) — delegate to a sub-agent with specific property extraction instructions to manage the large response

4. Generate modules — group resources by category; one `.bicep` file per group under `infra/modules/`. Use the schema from step 3 for property names, allowed values, and required fields.
5. Generate main.bicep — write `infra/main.bicep` that imports all modules and passes parameters
6. Generate parameters — create `infra/main.bicepparam` with environment-specific values

## Bicep Conventions

- Use `@description()` decorators on all parameters
- Use `@secure()` for secrets and connection strings
- Choose `targetScope` in `main.bicep` based on the deployment plan:
  - For single resource group deployments, set `targetScope = 'resourceGroup'` and deploy with `az deployment group create`.
  - For subscription-scope deployments (for example, resources across multiple resource groups or subscription-level resources), set `targetScope = 'subscription'` and deploy with `az deployment sub create`.
- Use `existing` keyword for referencing pre-existing resources
- Output resource IDs and endpoints needed by other resources
- Use `dependsOn` only when implicit dependencies are insufficient

## Parameter File Format

```bicep
using './main.bicep'

param location = 'eastus'
param environmentName = 'prod'
param workloadName = 'datapipeline'
```

## Multi-Environment

For multi-environment plans, generate one parameter file per environment:

```txt
infra/
├── main.bicep
├── main.dev.bicepparam
├── main.staging.bicepparam
└── main.prod.bicepparam
```

## Validation Before Deployment

Run `az bicep build --file infra/main.bicep` to validate syntax before deploying.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall