azure-well-architected

name	azure-well-architected
description	Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI, HPC, SaaS, AVD, AVS, or mission-critical workloads on Azure, and other Azure Well Architected related development tasks.
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

Azure Well Architected Skill

This skill provides expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Design Review Checklists	L35-L43	Checklists to review Azure workloads for cost, operations, performance, reliability, and security best practices and identify gaps against Well-Architected guidance.
Recommendations	L44-L117	Guidance on cost optimization, reliability, performance, security, and operational excellence in Azure workloads, including CI/CD, monitoring, incident management, and sustainable cloud practices.
Design Principles	L118-L132	Design patterns and best practices for cost, reliability, security, performance, operations, sustainability, and mission-critical design across AI, SaaS, AVD, HPC, and other Azure workloads.
Tradeoffs	L133-L142	Guidance on weighing cost, reliability, performance, security, and operations tradeoffs in Azure architectures, including regions/AZ choices and cross-pillar design decisions.
Service Guides	L143-L178	End-to-end Well-Architected (WAF) guidance for specific Azure services—covering design, networking, security/IAM, monitoring, BCDR, performance, and cost optimization patterns.
Workload Patterns	L179-L223	Design patterns, reference architectures, and end-to-end guidance for AI, HPC, mission-critical, SaaS, and sustainable workloads on Azure, including platforms, data, ops, security, and governance.
Assessment Questions	L224-L235	Guided assessments and maturity models to evaluate AI, SaaS, AVD, AVS, and other Azure workloads against WAF pillars: cost, reliability, security, performance, and operations.

Design Review Checklists

Topic	URL
Use Cost Optimization design review checklist for Azure	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/checklist
Use operational excellence design review checklist	https://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/checklist
Use performance efficiency design review checklist	https://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/checklist
Use reliability design checklist for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/reliability/checklist
Use the Security design review checklist for workloads	https://learn.microsoft.com/en-us/azure/well-architected/security/checklist

Recommendations

Topic	URL
Align Azure resource usage with billing increments	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/align-usage-to-billing-increments
Implement cost data collection and review for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/collect-review-cost-data
Use consolidation strategies to reduce Azure costs	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/consolidation
Build and maintain a cost model for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/cost-model
Create a culture of financial responsibility for cloud costs	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/create-culture-financial-responsibility
Negotiate and obtain best provider rates for Azure	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/get-best-rates
Reduce Azure workload costs through code optimization	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-code-costs
Optimize individual component costs in Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-component-costs
Optimize Azure data storage and management costs	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-data-costs
Optimize non-production and production environment costs	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/optimize-environment-costs

Design Principles

Topic	URL
Apply WAF design principles to AI workloads	https://learn.microsoft.com/en-us/azure/well-architected/ai/design-principles
Use architecture patterns that improve cost optimization	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/design-patterns
Apply Cost Optimization design principles in Azure	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/principles
Use WAF design principles for Azure HPC architectures	https://learn.microsoft.com/en-us/azure/well-architected/hpc/hpc-design-principles
Apply mission-critical design principles on Azure	https://learn.microsoft.com/en-us/azure/well-architected/mission-critical/mission-critical-design-principles
Apply Operational Excellence design principles in Azure	https://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/principles
Apply Performance Efficiency design principles in Azure	https://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/principles
Apply reliability design principles to Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/reliability/principles
Use WAF-aligned design principles for SaaS on Azure	https://learn.microsoft.com/en-us/azure/well-architected/saas/design-principles
Apply security design principles with zero trust	https://learn.microsoft.com/en-us/azure/well-architected/security/principles
Apply sustainability design methodology for Azure workloads

Tradeoffs

Topic	URL
Analyze cost optimization tradeoffs across WAF pillars	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/tradeoffs
Balance regions and availability zones for reliability and cost	https://learn.microsoft.com/en-us/azure/well-architected/design-guides/regions-availability-zones
Evaluate operational excellence tradeoffs in Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/tradeoffs
Analyze performance efficiency tradeoffs across WAF pillars	https://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/tradeoffs
Analyze reliability tradeoffs across WAF pillars	https://learn.microsoft.com/en-us/azure/well-architected/reliability/tradeoffs
Evaluate security tradeoffs in Azure architectures	https://learn.microsoft.com/en-us/azure/well-architected/security/tradeoffs

Service Guides

Topic	URL
Apply WAF best practices to Azure App Service Web Apps	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/app-service-web-apps
Configure Azure Monitor Application Insights using WAF guidance	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/application-insights
Apply WAF best practices to Azure API Management	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-api-management
Apply WAF best practices to Azure Application Gateway v2	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-application-gateway
Design and configure Azure Blob Storage with WAF best practices	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-blob-storage
Apply Well-Architected best practices to Azure Container Apps	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-container-apps
Apply WAF best practices to Azure Database for MySQL	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-database-for-mysql
Use WAF-aligned architecture for Azure Databricks	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-databricks
Optimize Azure Disk Storage using WAF guidance	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-disk-storage
Design Event Grid architectures with WAF best practices	https://learn.microsoft.com/en-us/azure/well-architected/service-guides/azure-event-grid

Workload Patterns

Topic	URL
Apply Well-Architected principles to AI workloads	https://learn.microsoft.com/en-us/azure/well-architected/ai/
Design AI-enabled applications on Azure using WAF	https://learn.microsoft.com/en-us/azure/well-architected/ai/application-design
Select application platforms for AI workloads on Azure	https://learn.microsoft.com/en-us/azure/well-architected/ai/application-platform
Use reference architecture patterns for Azure AI workloads	https://learn.microsoft.com/en-us/azure/well-architected/ai/architecture-pattern
Select and design data platforms for Azure AI	https://learn.microsoft.com/en-us/azure/well-architected/ai/data-platform
Use a structured design methodology for AI workloads	https://learn.microsoft.com/en-us/azure/well-architected/ai/design-methodology
Apply Well-Architected principles to Azure AI workloads	https://learn.microsoft.com/en-us/azure/well-architected/ai/get-started
Design grounding data for Azure AI applications	https://learn.microsoft.com/en-us/azure/well-architected/ai/grounding-data-design
Implement MLOps and GenAIOps for Azure AI workloads	https://learn.microsoft.com/en-us/azure/well-architected/ai/mlops-genaiops
Operate production AI workloads on Azure	https://learn.microsoft.com/en-us/azure/well-architected/ai/operations
Define roles and personas for Azure AI teams	https://learn.microsoft.com/en-us/azure/well-architected/ai/personas
Apply responsible AI practices in Azure workloads

Assessment Questions

Topic	URL
Use AI workload assessment for WAF alignment	https://learn.microsoft.com/en-us/azure/well-architected/ai/assessment
Assess Cost Optimization maturity for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/cost-optimization/maturity-model
Use Azure Well-Architected Review assessment effectively	https://learn.microsoft.com/en-us/azure/well-architected/design-guides/implementing-recommendations
Use mission-critical workload readiness assessment on Azure	https://learn.microsoft.com/en-us/azure/well-architected/mission-critical/mission-critical-assessment
Evaluate Operational Excellence maturity for workloads	https://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/maturity-model
Assess Performance Efficiency maturity for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/maturity-model
Assess reliability maturity for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/reliability/maturity-model
Use SaaS workload assessment tool for Azure architectures	https://learn.microsoft.com/en-us/azure/well-architected/saas/assessment
Evaluate security maturity for Azure workloads	https://learn.microsoft.com/en-us/azure/well-architected/security/maturity-model