azd-copilot Extension
AI-powered Azure development assistant that extends the Azure Developer CLI (azd) with
GitHub Copilot CLI integration, 16 specialized Azure agents, and 29+ focused skills.
When to Use
- Building Azure applications from natural language descriptions
- AI-assisted code review, security audits, and optimization
- Diagnosing deployment failures and production issues
- Interactive Azure development sessions with checkpoint/resume
- Generating infrastructure-as-code (Bicep/Terraform) with best practices
Commands
Interactive Session (default)
azd copilot # Start interactive session
azd copilot -p "deploy a Python API" # Start with a prompt
azd copilot --resume # Resume last session
azd copilot --agent azure-architect # Use a specific agent
azd copilot --yolo # Auto-approve all actions
azd copilot -m claude-sonnet-4 # Use a specific model
Build (2-Phase App Creation)
azd copilot build -p "React + FastAPI on Azure Container Apps"
azd copilot build --resume # Resume from checkpoint
The build command runs two phases:
- Spec phase: Generates a detailed application specification for review/approval
- Build phase: Implements the spec with infrastructure, application code, and deployment config
Quick Actions
| Command |
Description |
azd copilot init |
Initialize a new Azure project with AI guidance |
azd copilot review |
AI code review of current changes |
azd copilot fix |
Diagnose and fix issues in the codebase |
azd copilot optimize |
Suggest performance and cost optimizations |
azd copilot diagnose |
Troubleshoot deployment or runtime issues |
Management Commands
| Command |
Description |
azd copilot agents |
List available agents |
azd copilot skills |
List available skills |
azd copilot sessions |
Manage copilot sessions |
azd copilot checkpoints |
List and manage build checkpoints |
azd copilot spec |
View or edit the current build spec |
azd copilot context |
Show project context information |
azd copilot mcp |
Manage MCP server configuration |
azd copilot version |
Show version information |
16 Specialized Agents
| Agent |
Specialization |
azure-manager |
Orchestrates design, build, and deployment (default) |
azure-architect |
Infrastructure design and architecture decisions |
azure-dev |
Application code — backend, frontend, data layer |
azure-devops |
CI/CD, deployment, reliability, observability |
azure-data |
Database selection, schema design, query optimization |
azure-ai |
AI services, agent frameworks, RAG, model deployment |
azure-security |
Code security, infrastructure security, identity & auth |
azure-finance |
Cost estimation, optimization, waste identification |
azure-quality |
Testing, code review, refactoring, package evaluation |
azure-docs |
README, API docs, ADRs, runbooks |
azure-design |
WCAG compliance, accessibility audits, UI review |
azure-product |
Requirements, user stories, acceptance criteria |
azure-marketing |
Positioning, landing pages, competitive analysis |
azure-analytics |
Usage analytics, dashboards, metrics design |
azure-compliance |
Framework assessment (GDPR, SOC2, HIPAA), gap analysis |
azure-support |
Troubleshooting, FAQ generation, error messages |
Build Flow
- Run
azd copilot build -p "description"
- Spec is generated and presented for review
- Approve or edit the spec
- Build proceeds through phases with automatic checkpoints
- Resume anytime with
azd copilot build --resume
Checkpoints save progress at key milestones so builds can survive interruptions.
MCP Servers
azd-copilot configures these MCP servers for Copilot CLI:
- azure — Azure resource management and queries
- azd — Azure Developer CLI operations
- azd-app — Application-level project context
- microsoft-learn — Official Microsoft documentation search
- context7 — Library documentation lookup
- playwright — Browser automation for testing
Key Flags
| Flag |
Short |
Description |
--prompt |
-p |
Run with a specific prompt |
--resume |
-r |
Resume the last session |
--yolo |
-y |
Auto-approve all actions |
--agent |
-a |
Use a specific agent |
--model |
-m |
Use a specific AI model |
--add-dir |
|
Additional directories to include |
--verbose |
-v |
Verbose output |
--debug |
|
Enable debug logging |
--cwd |
-C |
Set working directory |
Common Workflows
New Azure App from Scratch
azd copilot build -p "Node.js API with Cosmos DB on Container Apps"
Review and Harden Existing App
azd copilot review
azd copilot --agent azure-security -p "audit this app for vulnerabilities"
azd copilot optimize
Troubleshoot a Failed Deployment
azd copilot diagnose
azd copilot --agent azure-devops -p "fix the CI/CD pipeline"
Cost Optimization
azd copilot --agent azure-finance -p "analyze costs and suggest savings"
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: jongio-azd-copilot-azd-copilot3description: azd-copilot Extension4---56# azd-copilot Extension78AI-powered Azure development assistant that extends the Azure Developer CLI (`azd`) with9GitHub Copilot CLI integration, 16 specialized Azure agents, and 29+ focused skills.1011## When to Use1213- Building Azure applications from natural language descriptions14- AI-assisted code review, security audits, and optimization15- Diagnosing deployment failures and production issues16- Interactive Azure development sessions with checkpoint/resume17- Generating infrastructure-as-code (Bicep/Terraform) with best practices1819## Commands2021### Interactive Session (default)2223```bash24azd copilot # Start interactive session25azd copilot -p "deploy a Python API" # Start with a prompt26azd copilot --resume # Resume last session27azd copilot --agent azure-architect # Use a specific agent28azd copilot --yolo # Auto-approve all actions29azd copilot -m claude-sonnet-4 # Use a specific model30```3132### Build (2-Phase App Creation)3334```bash35azd copilot build -p "React + FastAPI on Azure Container Apps"36azd copilot build --resume # Resume from checkpoint37```3839The build command runs two phases:401. **Spec phase**: Generates a detailed application specification for review/approval412. **Build phase**: Implements the spec with infrastructure, application code, and deployment config4243### Quick Actions4445| Command | Description |46|---------|-------------|47| `azd copilot init` | Initialize a new Azure project with AI guidance |48| `azd copilot review` | AI code review of current changes |49| `azd copilot fix` | Diagnose and fix issues in the codebase |50| `azd copilot optimize` | Suggest performance and cost optimizations |51| `azd copilot diagnose` | Troubleshoot deployment or runtime issues |5253### Management Commands5455| Command | Description |56|---------|-------------|57| `azd copilot agents` | List available agents |58| `azd copilot skills` | List available skills |59| `azd copilot sessions` | Manage copilot sessions |60| `azd copilot checkpoints` | List and manage build checkpoints |61| `azd copilot spec` | View or edit the current build spec |62| `azd copilot context` | Show project context information |63| `azd copilot mcp` | Manage MCP server configuration |64| `azd copilot version` | Show version information |6566## 16 Specialized Agents6768| Agent | Specialization |69|-------|---------------|70| `azure-manager` | Orchestrates design, build, and deployment (default) |71| `azure-architect` | Infrastructure design and architecture decisions |72| `azure-dev` | Application code — backend, frontend, data layer |73| `azure-devops` | CI/CD, deployment, reliability, observability |74| `azure-data` | Database selection, schema design, query optimization |75| `azure-ai` | AI services, agent frameworks, RAG, model deployment |76| `azure-security` | Code security, infrastructure security, identity & auth |77| `azure-finance` | Cost estimation, optimization, waste identification |78| `azure-quality` | Testing, code review, refactoring, package evaluation |79| `azure-docs` | README, API docs, ADRs, runbooks |80| `azure-design` | WCAG compliance, accessibility audits, UI review |81| `azure-product` | Requirements, user stories, acceptance criteria |82| `azure-marketing` | Positioning, landing pages, competitive analysis |83| `azure-analytics` | Usage analytics, dashboards, metrics design |84| `azure-compliance` | Framework assessment (GDPR, SOC2, HIPAA), gap analysis |85| `azure-support` | Troubleshooting, FAQ generation, error messages |8687## Build Flow88891. Run `azd copilot build -p "description"`902. Spec is generated and presented for review913. Approve or edit the spec924. Build proceeds through phases with automatic checkpoints935. Resume anytime with `azd copilot build --resume`9495Checkpoints save progress at key milestones so builds can survive interruptions.9697## MCP Servers9899azd-copilot configures these MCP servers for Copilot CLI:100101- **azure** — Azure resource management and queries102- **azd** — Azure Developer CLI operations103- **azd-app** — Application-level project context104- **microsoft-learn** — Official Microsoft documentation search105- **context7** — Library documentation lookup106- **playwright** — Browser automation for testing107108## Key Flags109110| Flag | Short | Description |111|------|-------|-------------|112| `--prompt` | `-p` | Run with a specific prompt |113| `--resume` | `-r` | Resume the last session |114| `--yolo` | `-y` | Auto-approve all actions |115| `--agent` | `-a` | Use a specific agent |116| `--model` | `-m` | Use a specific AI model |117| `--add-dir` | | Additional directories to include |118| `--verbose` | `-v` | Verbose output |119| `--debug` | | Enable debug logging |120| `--cwd` | `-C` | Set working directory |121122## Common Workflows123124### New Azure App from Scratch125126```bash127azd copilot build -p "Node.js API with Cosmos DB on Container Apps"128```129130### Review and Harden Existing App131132```bash133azd copilot review134azd copilot --agent azure-security -p "audit this app for vulnerabilities"135azd copilot optimize136```137138### Troubleshoot a Failed Deployment139140```bash141azd copilot diagnose142azd copilot --agent azure-devops -p "fix the CI/CD pipeline"143```144145### Cost Optimization146147```bash148azd copilot --agent azure-finance -p "analyze costs and suggest savings"149```150151---152> Converted and distributed by [TomeVault](https://tomevault.io/claim/jongio) — claim your Tome and manage your conversions.153<!-- tomevault:4.0:skill_md:2026-04-13 -->
tomevault-io