mirror of
https://github.com/github/awesome-copilot.git
synced 2026-04-14 04:05:58 +00:00
Add azure-architecture-autopilot skill 🤖🤖🤖 (#1158)
* Add azure-architecture-autopilot skill E2E Azure infrastructure automation skill: - Natural language → Architecture diagram → Bicep → Deploy - 70+ service types with 605+ official Azure icons - Interactive HTML diagrams (drag, zoom, click, PNG export) - Scans existing resources or designs new architecture - Modular Bicep with RBAC, Private Endpoints, DNS - Multi-language support (auto-detects user language) - Zero dependencies (diagram engine embedded) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix generator.py import for flat scripts/ structure + sync README Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: whoniiii <whoniiii@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
Jeonghoon Lee
GitHub
188
skills/azure-architecture-autopilot/README.md
Normal file
188
skills/azure-architecture-autopilot/README.md
Normal file
@@ -0,0 +1,188 @@
|
||||
<h1 align="center">Azure Architecture Autopilot</h1>
|
||||
|
||||
<p align="center">
|
||||
<strong>Design → Diagram → Bicep → Deploy — all from natural language</strong>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/badge/GitHub_Copilot-Skill-8957e5?logo=github" alt="Copilot Skill">
|
||||
<img src="https://img.shields.io/badge/Azure-All_Services-0078D4?logo=microsoftazure&logoColor=white" alt="Azure">
|
||||
<img src="https://img.shields.io/badge/Bicep-IaC-ff6f00" alt="Bicep">
|
||||
<img src="https://img.shields.io/badge/70+-Service_Types-00bcf2" alt="Service Types">
|
||||
<img src="https://img.shields.io/badge/License-MIT-green" alt="License">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<b>Azure Architecture Autopilot</b> designs Azure infrastructure from natural language,<br>
|
||||
generates interactive diagrams, produces modular Bicep templates, and deploys — all through conversation.<br>
|
||||
It also scans existing resources, visualizes them as architecture diagrams, and refines them on the fly.
|
||||
</p>
|
||||
|
||||
<!-- Hero image: interactive architecture diagram with 605+ Azure icons -->
|
||||
<p align="center">
|
||||
<img src="assets/06-architecture-diagram.png" width="100%" alt="Interactive Azure architecture diagram with 605+ official icons">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<em>↑ Auto-generated interactive diagram — drag, zoom, click for details, export to PNG</em>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="assets/08-deployment-succeeded.png" width="80%" alt="Deployment succeeded">
|
||||
|
||||
<img src="assets/07-azure-portal-resources.png" width="80%" alt="Azure Portal — deployed resources">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<em>↑ Real Azure resources deployed from the generated Bicep templates</em>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="#-how-it-works">How It Works</a> •
|
||||
<a href="#-features">Features</a> •
|
||||
<a href="#%EF%B8%8F-prerequisites">Prerequisites</a> •
|
||||
<a href="#-usage">Usage</a> •
|
||||
<a href="#-architecture">Architecture</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
## 🔄 How It Works
|
||||
|
||||
```
|
||||
Path A: "Build me a RAG chatbot on Azure"
|
||||
↓
|
||||
🎨 Design → 🔧 Bicep → ✅ Review → 🚀 Deploy
|
||||
|
||||
Path B: "Analyze my current Azure resources"
|
||||
↓
|
||||
🔍 Scan → 🎨 Modify → 🔧 Bicep → ✅ Review → 🚀 Deploy
|
||||
```
|
||||
|
||||
| Phase | Role | What Happens |
|
||||
|:-----:|------|--------------|
|
||||
| **0** | 🔍 Scanner | Scans existing Azure resources via `az` CLI → auto-generates architecture diagram |
|
||||
| **1** | 🎨 Advisor | Interactive design through conversation — asks targeted questions with smart defaults |
|
||||
| **2** | 🔧 Generator | Produces modular Bicep: `main.bicep` + `modules/*.bicep` + `.bicepparam` |
|
||||
| **3** | ✅ Reviewer | Compiles with `az bicep build`, checks security & best practices |
|
||||
| **4** | 🚀 Deployer | `validate` → `what-if` → preview diagram → `create` (5-step mandatory sequence) |
|
||||
|
||||
---
|
||||
|
||||
## ✨ Features
|
||||
|
||||
| | Feature | Description |
|
||||
|---|---------|-------------|
|
||||
| 📦 | **Zero Dependencies** | 605+ Azure icons bundled — no `pip install`, works offline |
|
||||
| 🎨 | **Interactive Diagrams** | Drag-and-drop HTML with zoom, click details, PNG export |
|
||||
| 🔍 | **Resource Scanning** | Analyze existing Azure infra → auto-generate architecture diagrams |
|
||||
| 💬 | **Natural Language** | *"It's slow"*, *"reduce costs"*, *"add security"* → guided resolution |
|
||||
| 📊 | **Live Verification** | API versions, SKUs, model availability fetched from MS Docs in real-time |
|
||||
| 🔒 | **Secure by Default** | Private Endpoints, RBAC, managed identity — no secrets in files |
|
||||
| ⚡ | **Parallel Preload** | Next-phase info loaded while waiting for user input |
|
||||
| 🌐 | **Multi-Language** | Auto-detects user language — responds in English, Korean, or any language |
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Prerequisites
|
||||
|
||||
| Tool | Required | Install |
|
||||
|------|:--------:|---------|
|
||||
| **GitHub Copilot CLI** | ✅ | [Install guide](https://docs.github.com/copilot/concepts/agents/about-copilot-cli) |
|
||||
| **Azure CLI** | ✅ | `winget install Microsoft.AzureCLI` / `brew install azure-cli` |
|
||||
| **Python 3.10+** | ✅ | `winget install Python.Python.3.12` / `brew install python` |
|
||||
|
||||
> No additional packages required — the diagram engine is bundled in `scripts/`.
|
||||
|
||||
### 🤖 Recommended Models
|
||||
|
||||
| | Models | Notes |
|
||||
|---|--------|-------|
|
||||
| 🏆 **Best** | Claude Opus 4.5 / 4.6 | Most reliable for all 5 phases |
|
||||
| ✅ **Recommended** | Claude Sonnet 4.5 / 4.6 | Best cost-performance balance |
|
||||
| ⚠️ **Minimum** | Claude Sonnet 4, GPT-5.1+ | May skip steps in complex architectures |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Usage
|
||||
|
||||
### Path A — Build new infrastructure
|
||||
|
||||
```
|
||||
"Build a RAG chatbot with Foundry and AI Search"
|
||||
"Create a data platform with Databricks and ADLS Gen2"
|
||||
"Deploy Fabric + ADF pipeline with private endpoints"
|
||||
"Set up a microservices architecture with AKS and Cosmos DB"
|
||||
```
|
||||
|
||||
### Path B — Analyze & modify existing resources
|
||||
|
||||
```
|
||||
"Analyze my current Azure infrastructure"
|
||||
"Scan rg-production and show me the architecture"
|
||||
"What resources are in my subscription?"
|
||||
```
|
||||
|
||||
Then modify through conversation:
|
||||
```
|
||||
"Add 3 VMs to this architecture"
|
||||
"The Foundry endpoint is slow — what can I do?"
|
||||
"Reduce costs — downgrade AI Search to Basic"
|
||||
"Add private endpoints to all services"
|
||||
```
|
||||
|
||||
### 📂 Output Structure
|
||||
|
||||
```
|
||||
<project-name>/
|
||||
├── 00_arch_current.html ← Scanned architecture (Path B)
|
||||
├── 01_arch_diagram_draft.html ← Design diagram
|
||||
├── 02_arch_diagram_preview.html ← What-if preview
|
||||
├── 03_arch_diagram_result.html ← Deployment result
|
||||
├── main.bicep ← Orchestration
|
||||
├── main.bicepparam ← Parameter values
|
||||
└── modules/
|
||||
└── *.bicep ← Per-service modules
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 Architecture
|
||||
|
||||
```
|
||||
SKILL.md ← Lightweight router (~170 lines)
|
||||
│
|
||||
├── scripts/ ← Embedded diagram engine
|
||||
│ ├── generator.py ← Interactive HTML generator
|
||||
│ ├── icons.py ← 605+ Azure icons (Base64 SVG)
|
||||
│ └── cli.py ← CLI entry point
|
||||
│
|
||||
└── references/ ← Phase instructions + patterns
|
||||
├── phase0-scanner.md ← 🔍 Resource scanning
|
||||
├── phase1-advisor.md ← 🎨 Architecture design
|
||||
├── bicep-generator.md ← 🔧 Bicep generation
|
||||
├── bicep-reviewer.md ← ✅ Code review
|
||||
├── phase4-deployer.md ← 🚀 Deployment pipeline
|
||||
├── service-gotchas.md ← Required properties & PE mappings
|
||||
├── azure-common-patterns.md ← Security & naming patterns
|
||||
├── azure-dynamic-sources.md ← MS Docs URL registry
|
||||
├── architecture-guidance-sources.md
|
||||
└── ai-data.md ← AI/Data service domain pack
|
||||
```
|
||||
|
||||
> **Self-contained** — `SKILL.md` is a lightweight router. All phase logic lives in `references/`. The diagram engine is embedded in `scripts/` with no external dependencies.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Supported Services (70+ types)
|
||||
|
||||
All Azure services supported. AI/Data services have optimized templates; others are auto-looked up from MS Docs.
|
||||
|
||||
**Key types:** `ai_foundry` · `openai` · `ai_search` · `storage` · `adls` · `keyvault` · `fabric` · `databricks` · `aks` · `vm` · `app_service` · `function_app` · `cosmos_db` · `sql_server` · `postgresql` · `mysql` · `synapse` · `adf` · `apim` · `service_bus` · `logic_apps` · `event_grid` · `event_hub` · `container_apps` · `app_insights` · `log_analytics` · `firewall` · `front_door` · `load_balancer` · `expressroute` · `sentinel` · `redis` · `iot_hub` · `digital_twins` · `signalr` · `acr` · `bastion` · `vpn_gateway` · `data_explorer` · `document_intelligence` ...
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 📄 License
|
||||
|
||||
MIT © [Jeonghoon Lee](https://github.com/whoniiii)
|
||||
Reference in New Issue
Block a user