Agentic InfraOps

Version 3.7.8 | Changelog

🔗 Shortlink: aka.ms/agenticinfraops

---

Azure infrastructure engineered by agents. Verified. Well-Architected. Deployable.

Agentic InfraOps revolutionizes how IT Pros build Azure environments. Powered by GitHub Copilot and coordinated AI agents, it transforms requirements into architecture diagrams, validated designs, and deploy-ready Bicep/Terraform templates—all aligned with Azure Well-Architected best practices and Azure Verified Modules. Real-time pricing, compliance checks, and automation included.

📖 Quick Start Guide | 📋 Full Workflow Docs | 🎯 Scenarios | 💰 Azure Pricing MCP

🎬 The Workflow

%%{init: {'theme':'base', 'themeVariables': {'primaryColor': '#0078D4', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#005A9E', 'lineColor': '#6B7280', 'secondaryColor': '#00B4AB', 'tertiaryColor': '#8957E5', 'background': '#ffffff', 'mainBkg': '#ffffff', 'nodeBorder': '#005A9E', 'clusterBkg': '#F3F4F6', 'titleColor': '#1F2937', 'edgeLabelBackground': '#ffffff'}}}%%
graph LR
    P["🎯 @plan<br/>Step 1"]:::plan --> A["🏛️ architect<br/>Step 2"]:::architect
    A --> D3["📊 Design<br/>Step 3"]:::artifact
    D3 --> B["📋 bicep-plan<br/>Step 4"]:::bicep
    B --> I["⚙️ implement<br/>Step 5"]:::bicep
    I --> DEP["🚀 Deploy<br/>Step 6"]:::deploy
    DEP --> D7["📊 As-Built<br/>Step 7"]:::artifact
    MCP["💰 Pricing MCP"]:::pricing -.->|costs| A
    MCP -.->|validation| B

    classDef plan fill:#8957E5,stroke:#6B46C1,color:#fff
    classDef architect fill:#0078D4,stroke:#005A9E,color:#fff
    classDef bicep fill:#00B4AB,stroke:#008F89,color:#fff
    classDef pricing fill:#FF6B35,stroke:#E55A25,color:#fff
    classDef artifact fill:#6B7280,stroke:#4B5563,color:#fff
    classDef deploy fill:#10B981,stroke:#059669,color:#fff

Loading

Agent Legend

Color	Agent/Phase	Role
🟣	@plan	Gather and refine requirements
🔵	azure-principal-architect	WAF assessment (NO code)
⚫	Design / As-Built Artifacts	Diagrams & ADRs (-des/-ab suffix)
🟢	bicep-plan / bicep-implement	Implementation plan & Bicep generation
🟠	Azure Pricing MCP	Real-time cost estimation
🟩	Deploy / As-Built	Azure deployment + documentation

Step	Agent/Phase	What It Does
1	@plan	Gather requirements → 01-*
2	azure-principal-architect	WAF assessment (NO code) 💰 → 02-*
3	Design Artifacts	Design diagrams + ADRs (-des) → 03-*
4	bicep-plan	Implementation plan + governance 💰 → 04-*
5	bicep-implement	Generate & validate Bicep → 05-*
6	Deploy	Deploy to Azure → 06-*
7	As-Built Artifacts	As-built diagrams, ADRs, docs → 07-*

💰 = Azure Pricing MCP integration. Steps 3 & 7 are optional.

---

Quick Start

Get up and running in 5 steps:

Step	Action	Details
1️⃣	Install Prerequisites	Docker Desktop + VS Code + Copilot
2️⃣	Clone & Open	git clone https://github.com/jonathan-vella/azure-agentic-infraops.git then code azure-agentic-infraops
3️⃣	Open in Dev Container	Press F1 → "Dev Containers: Reopen in Container" (wait ~2 min)
4️⃣	Open Copilot Chat	Press Ctrl+Alt+I → Click Agent button (Ctrl+Shift+A) → Select @plan
5️⃣	Try It	Type: @plan Create a web app with Azure App Service and SQL Database

Each agent asks for approval before proceeding. Say yes to continue, or provide feedback to refine.

📖 Full Quick Start Guide → (includes troubleshooting, demo scenarios, deployment instructions)

Using the Accelerator

To simplify bootstrapping agentic infrastructure operations on Azure, we recommend starting with the azure-agentic-infraops-accelerator template repository. Click "Use this template" on the accelerator to generate a new repository pre-configured for Azure Agentic InfraOps and use it alongside this repository for adaptable deployments and workflows.

---

Project Structure

Directory	Purpose
.github/agents/	Agent definitions (7 agents for 7-step flow)
agent-output/	Generated artifacts per project
mcp/azure-pricing-mcp/	💰 Real-time Azure pricing MCP server
infra/bicep/	Generated Bicep templates
docs/	Documentation, guides, diagrams
scenarios/	11 hands-on learning scenarios

---

🎯 Scenarios

11 hands-on scenarios from beginner to advanced (15-45 min each):

Level	Topics
Beginner	Bicep/Terraform baselines, documentation generation, diagrams as code
Intermediate	Service validation, troubleshooting, SBOM generation
Advanced	Full agentic workflow, async coding agent

📖 Full Scenarios Guide →

---

Why Agentic InfraOps?

Efficiency multiplier: Reduce infrastructure development time by 60-90% while delivering Well-Architected, deploy-ready Azure infrastructure.

Benefit	Details
AVM-First	Azure Verified Modules for policy-compliant deployments (ADR-003)
Time Savings	Quantified evidence: 45 min vs 18+ hours (time-savings-evidence)
Real Portfolios	See real projects built with agentic workflows (portfolio showcase)

---

📋 Requirements

Requirement	Details
VS Code	With GitHub Copilot extension
Dev Container	Docker Desktop or GitHub Codespaces
Azure subscription	For deployments (optional for learning)

Included in Dev Container:

• ✅ Azure CLI with Bicep extension
• ✅ PowerShell 7+ and Python 3.10+
• ✅ All required VS Code extensions
• ✅ Azure Pricing MCP server (auto-configured)

---

Looking for a quick start? Check out the agentic InfraOps accelerator template: azure-agentic-infraops-accelerator.

---

Contributing | License (MIT)