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, SAP, SaaS, HPC, or mission‑critical workloads, or optimizing cost, security, reliability, and ops, 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-04-19","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, with concrete questions and best practices for each architecture pillar.
Recommendations	L44-L115	Guidance and best practices to design, operate, and improve Azure workloads across cost, operations, performance, reliability, security, and sustainability (FinOps, DevOps, DR, CI/CD, IAM, monitoring).
Design Principles	L116-L133	Design principles and patterns for cost, reliability, security, performance, ops, and sustainability across Azure workloads like AI, SAP, Oracle, AVS, AVD, SaaS, HPC, and mission‑critical systems.
Tradeoffs	L134-L143	Guidance on balancing cost, reliability, performance, security, and operations in Azure designs, including region/AZ choices and cross-pillar tradeoff analysis for architecture decisions
Service Guides	L144-L194	End-to-end design, security, networking, operations, monitoring, and optimization guidance for specific Azure services, aligned to Well-Architected Framework best practices.
Workload Patterns	L195-L255	Designing, operating, and optimizing specialized Azure workloads (AI, HPC, mission‑critical, SaaS, SAP, sustainability) using Well‑Architected principles for architecture, data, ops, security, and cost.
Assessment Questions	L256-L269	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 the Performance Efficiency design review checklist	https://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/checklist
Use reliability design review checklist for Azure	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
Collect and review Azure workload cost data effectively	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
Apply WAF design principles to Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/design-principles
Apply WAF design principles to Azure VMware Solution	https://learn.microsoft.com/en-us/azure/well-architected/azure-vmware/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
Use 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

Tradeoffs

Topic	URL
Evaluate 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
Analyze Operational Excellence tradeoffs across WAF pillars	https://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/tradeoffs
Evaluate Performance Efficiency tradeoffs across WAF pillars	https://learn.microsoft.com/en-us/azure/well-architected/performance-efficiency/tradeoffs
Evaluate cross-pillar tradeoffs for reliability designs	https://learn.microsoft.com/en-us/azure/well-architected/reliability/tradeoffs
Analyze security tradeoffs across WAF pillars	https://learn.microsoft.com/en-us/azure/well-architected/security/tradeoffs

Service Guides

Topic	URL
Design application delivery for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/application-delivery
Plan business continuity for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/business-continuity
Integrate Azure Virtual Desktop with Azure landing zones	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/landing-zone-integration
Implement monitoring for Azure Virtual Desktop workloads	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/monitoring
Design networking and connectivity for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/networking
Define operations procedures for Azure Virtual Desktop	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/operations
Secure Azure Virtual Desktop and manage IAM	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/security
Optimize storage for Azure Virtual Desktop workloads	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/storage
Design application platforms on Azure VMware Solution	https://learn.microsoft.com/en-us/azure/well-architected/azure-vmware/application-platform
Design infrastructure for Azure VMware Solution workloads	https://learn.microsoft.com/en-us/azure/well-architected/azure-vmware/infrastructure

Workload Patterns

Topic	URL
Apply Well-Architected principles to Azure 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
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 WAF to AI workloads on Azure	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	https://learn.microsoft.com/en-us/azure/well-architected/ai/responsible-ai
Test and evaluate Azure AI models and systems

Assessment Questions

Topic	URL
Use AI workload assessment for WAF alignment	https://learn.microsoft.com/en-us/azure/well-architected/ai/assessment
Use the Azure Virtual Desktop WAF assessment	https://learn.microsoft.com/en-us/azure/well-architected/azure-virtual-desktop/assessment
Use the Azure VMware Solution WAF assessment	https://learn.microsoft.com/en-us/azure/well-architected/azure-vmware/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