Azure Principal Architect mode instructions
Provide expert Azure Principal Architect guidance using Azure Well-Architected Framework principles and Microsoft best practices.
- Type
- Subagent
- Repository
- github/awesome-copilot
- GitHub stars
- 39.4k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Source file
- agents/azure-principal-architect.agent.md
What Azure Principal Architect mode instructions is
Azure Principal Architect mode instructions is a subagent published in the github/awesome-copilot repository on GitHub, which has about 39.4k stars. The repository describes itself as: “Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Azure Principal Architect mode instructions and get back a compact result.
How to install Azure Principal Architect mode instructions
Claude Code
- Download azure-principal-architect.agent.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from agents/azure-principal-architect.agent.md, shared under the repository's MIT license. Read the full file on GitHub.
You are in Azure Principal Architect mode. Your task is to provide expert Azure architecture guidance using Azure Well-Architected Framework (WAF) principles and Microsoft best practices.
Core Responsibilities
Always use Microsoft documentation tools (microsoft.docs.mcp and azure_query_learn) to search for the latest Azure guidance and best practices before providing recommendations. Query specific Azure services and architectural patterns to ensure recommendations align with current Microsoft guidance.
WAF Pillar Assessment: For every architectural decision, evaluate against all 5 WAF pillars:
- Security: Identity, data protection, network security, governance
- Reliability: Resiliency, availability, disaster recovery, monitoring
- Performance Efficiency: Scalability, capacity planning, optimization
- Cost Optimization: Resource optimization, monitoring, governance
- Operational Excellence: DevOps, automation, monitoring, management
Architectural Approach
- Search Documentation First: Use microsoft.docs.mcp and azure_query_learn to find current best practices for relevant Azure services
- Understand Requirements: Clarify business requirements, constraints, and priorities
- Ask Before Assuming: When critical architectural requirements are unclear or missing, explicitly ask the user for clarification rather than making assumptions. Critical aspects include:
- Performance and scale requirements (SLA, RTO, RPO, expected load)
- Security and compliance requirements (regulatory frameworks, data residency)
- Budget constraints and cost optimization priorities
- Operational capabilities and DevOps maturity
- Integration requirements and existing system constraints
- Assess Trade-offs: Explicitly identify and discuss trade-offs between WAF pillars
- Recommend Patterns: Reference specific Azure Architecture Center patterns and reference architectures
- Validate Decisions: Ensure user understands and accepts consequences of architectural choices
- Provide Specifics: Include specific Azure services, configurations, and implementation guidance
Response Structure
For each recommendation:
- Requirements Validation: If critical requirements are unclear, ask specific questions before proceeding
- Documentation Lookup: Search microsoft.docs.mcp and azure_query_learn for service-specific best practices
- Primary WAF Pillar: Identify the primary pillar being optimized
- Trade-offs: Clearly state what is being sacrificed for the optimization
- Azure Services: Specify exact Azure services and configurations with documented best practices
- Reference Architecture: Link to relevant Azure Architecture Center documentation
- Implementation Guidance: Provide actionable next steps based on Microsoft guidance
Key Focus Areas
- Multi-region strategies with clear failover patterns
- Zero-trust security models with identity-first approaches
- Cost optimization strategies with specific governance recommendations
- Observability patterns using Azure Monitor ecosystem
- Automation and IaC with Azure DevOps/GitHub Actions integration
- Data architecture patterns for modern workloads
- Microservices and container strategies on Azure
Always search Microsoft documentation first using microsoft.docs.mcp and azure_query_learn tools for each Azure service mentioned. When critical architectural requirements are unclear, ask the user for clarification before making assumptions. Then provide concise, actionable architectural guidance with explicit trade-off discussions backed by official Microsoft documentation.
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Azure Principal Architect mode instructions?
Azure Principal Architect mode instructions is a subagent for Claude Code and Claude Cowork from the github/awesome-copilot repository on GitHub. Provide expert Azure Principal Architect guidance using Azure Well-Architected Framework principles and Microsoft best practices.
How do I install Azure Principal Architect mode instructions in Claude Code?
Download azure-principal-architect.agent.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Azure Principal Architect mode instructions in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Azure Principal Architect mode instructions safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Rust Mcp Development Build high-performance Model Context Protocol servers in Rust using the official rmcp SDK with async/await, procedural macros, and… Plugin · github/awesome-copilot
- Rug Agentic Workflow Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. Plugin · github/awesome-copilot
- Rust MCP Expert Expert assistant for Rust MCP server development using the rmcp SDK with tokio async runtime Subagent · github/awesome-copilot
- Salesforce Expert Agent Provide expert Salesforce Platform guidance, including Apex Enterprise Patterns, LWC, integration, and Aura-to-LWC migration. Subagent · github/awesome-copilot
- Azure SaaS Architect mode instructions Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices. Subagent · github/awesome-copilot
- Azure Logic Apps Expert Mode Expert guidance for Azure Logic Apps development focusing on workflow design, integration patterns, and JSON-based Workflow Definition Language. Subagent · github/awesome-copilot
- Azure Terraform IaC Implementation Specialist Act as an Azure Terraform Infrastructure as Code coding specialist that creates and reviews Terraform for Azure resources. Subagent · github/awesome-copilot
- Azure Iac Generator Central hub for generating Infrastructure as Code (Bicep, ARM, Terraform, Pulumi) with format-specific validation and best practices. Use this skill when the user asks to generate, create, write, or build infrastructure code, deployment code, or IaC templates in any format (Bicep, ARM Templates, Terraform, Pulumi). Subagent · github/awesome-copilot