Cloud Design Patterns Instruction

[fatihdurgut]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.

---

Description

This PR adds a new instruction file for Cloud Design Patterns that provides comprehensive guidance on 42 industry-standard design patterns for distributed systems architecture.

The instruction file covers patterns from the Microsoft Azure Architecture Center and is organized into the following categories:

Reliability & Resilience Patterns (13 patterns) - Ambassador, Bulkhead, Circuit Breaker, Compensating Transaction, Retry, Health Endpoint Monitoring, Leader Election, Saga, Sequential Convoy, and more
Performance Patterns (11 patterns) - Asynchronous Request-Reply, Cache-Aside, CQRS, Index Table, Materialized View, Priority Queue, Queue-Based Load Leveling, Rate Limiting, Sharding, Throttling
Messaging & Integration Patterns (7 patterns) - Choreography, Claim Check, Competing Consumers, Messaging Bridge, Pipes and Filters, Publisher-Subscriber, Scheduler Agent Supervisor
Architecture & Design Patterns (9 patterns) - Anti-Corruption Layer, Backends for Frontends, Gateway Aggregation, Gateway Offloading, Gateway Routing, Sidecar, Strangler Fig
Deployment & Operational Patterns (6 patterns) - Compute Resource Consolidation, Deployment Stamps, External Configuration Store, Geode, Static Content Hosting
Security Patterns (3 patterns) - Federated Identity, Quarantine, Valet Key
Event-Driven Architecture Patterns (1 pattern) - Event Sourcing
Each pattern includes:

Problem statement
Solution description
When to use guidance
Implementation considerations with Azure-specific recommendations
The instruction applies to infrastructure code (Bicep, Terraform), application code (C#, Java, Python, JavaScript/TypeScript, Go), and architecture documentation files.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• Update to existing instruction, prompt, agent, plugin, skill, or workflow.
• Other (please specify):

---

Additional Notes

The instruction file is technology-agnostic and can be applied across Azure, other cloud platforms, on-premises setups, and hybrid environments
Content sourced from official Microsoft Learn documentation: https://learn.microsoft.com/en-us/azure/architecture/patterns/

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[Copilot]

Pull request overview

Adds a large set of new Copilot plugin agents/skills and simplifies plugin manifests, alongside documenting a new Cloud Design Patterns instruction entry.

Changes:

• Added multiple new agent definitions across partner, language, and cloud/devops plugins.
• Added several new skill SKILL.md files (e.g., OpenAPI-to-app generation, Java, Dataverse, DB review).
• Updated many plugin.json manifests (notably switching from enumerating agents/skills to referencing agent/skill directories) and updated docs/README.instructions.md.

Reviewed changes

Copilot reviewed 138 out of 247 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
plugins/partners/agents/jfrog-sec.md	Adds a partner security remediation agent definition.
plugins/partners/agents/elasticsearch-observability.md	Adds an Elastic observability/security agent definition with MCP server config.
plugins/partners/agents/diffblue-cover.md	Adds a Diffblue Cover unit-test generation agent definition.
plugins/partners/agents/arm-migration.md	Adds an Arm migration agent definition and workflow steps.
plugins/partners/agents/amplitude-experiment-implementation.md	Adds an Amplitude experiment implementation agent definition.
plugins/partners/.github/plugin/plugin.json	Changes partner plugin agent registration to reference the agents directory.
plugins/ospo-sponsorship/.github/plugin/plugin.json	Normalizes skills path formatting (removes trailing slash).
plugins/openapi-to-application-python-fastapi/skills/openapi-to-application-code/SKILL.md	Adds OpenAPI-to-app generation skill (FastAPI plugin).
plugins/openapi-to-application-python-fastapi/agents/openapi-to-application.md	Adds OpenAPI-to-app generator agent (FastAPI plugin).
plugins/openapi-to-application-python-fastapi/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/openapi-to-application-nodejs-nestjs/skills/openapi-to-application-code/SKILL.md	Adds OpenAPI-to-app generation skill (NestJS plugin).
plugins/openapi-to-application-nodejs-nestjs/agents/openapi-to-application.md	Adds OpenAPI-to-app generator agent (NestJS plugin).
plugins/openapi-to-application-nodejs-nestjs/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/openapi-to-application-java-spring-boot/skills/openapi-to-application-code/SKILL.md	Adds OpenAPI-to-app generation skill (Spring Boot plugin).
plugins/openapi-to-application-java-spring-boot/agents/openapi-to-application.md	Adds OpenAPI-to-app generator agent (Spring Boot plugin).
plugins/openapi-to-application-java-spring-boot/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/openapi-to-application-go/skills/openapi-to-application-code/SKILL.md	Adds OpenAPI-to-app generation skill (Go plugin).
plugins/openapi-to-application-go/agents/openapi-to-application.md	Adds OpenAPI-to-app generator agent (Go plugin).
plugins/openapi-to-application-go/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/openapi-to-application-csharp-dotnet/skills/openapi-to-application-code/SKILL.md	Adds OpenAPI-to-app generation skill (.NET plugin).
plugins/openapi-to-application-csharp-dotnet/agents/openapi-to-application.md	Adds OpenAPI-to-app generator agent (.NET plugin).
plugins/openapi-to-application-csharp-dotnet/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/noob-mode/.github/plugin/plugin.json	Normalizes skills path formatting (removes trailing slash).
plugins/mcp-m365-copilot/agents/mcp-m365-agent-expert.md	Adds an MCP/M365 declarative agent expert definition.
plugins/mcp-m365-copilot/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
plugins/kotlin-mcp-development/agents/kotlin-mcp-expert.md	Adds Kotlin MCP server development expert agent.
plugins/kotlin-mcp-development/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/java-mcp-development/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/java-development/skills/java-springboot/SKILL.md	Adds Java Spring Boot best-practices skill.
plugins/java-development/skills/java-junit/SKILL.md	Adds Java JUnit best-practices skill.
plugins/java-development/skills/java-docs/SKILL.md	Adds Java Javadoc best-practices skill.
plugins/java-development/skills/create-spring-boot-java-project/SKILL.md	Adds Spring Boot project scaffolding skill instructions.
plugins/java-development/.github/plugin/plugin.json	Normalizes skills paths in plugin manifest.
plugins/go-mcp-development/agents/go-mcp-expert.md	Adds Go MCP server development expert agent.
plugins/go-mcp-development/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/gem-team/agents/gem-reviewer.md	Adds GEM reviewer agent definition.
plugins/gem-team/agents/gem-implementer.md	Adds GEM implementer agent definition.
plugins/gem-team/agents/gem-documentation-writer.md	Adds GEM documentation writer agent definition.
plugins/gem-team/agents/gem-devops.md	Adds GEM devops agent definition.
plugins/gem-team/agents/gem-browser-tester.md	Adds GEM browser tester agent definition.
plugins/gem-team/.github/plugin/plugin.json	Changes GEM plugin agent registration to reference the agents directory.
plugins/frontend-web-dev/skills/playwright-generate-test/SKILL.md	Adds Playwright test generation skill instructions.
plugins/frontend-web-dev/skills/playwright-explore-website/SKILL.md	Adds Playwright website exploration skill instructions.
plugins/frontend-web-dev/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
plugins/edge-ai-tasks/.github/plugin/plugin.json	Changes edge-ai plugin agent registration to reference the agents directory.
plugins/devops-oncall/skills/multi-stage-dockerfile/SKILL.md	Adds multi-stage Dockerfile best-practices skill.
plugins/devops-oncall/agents/azure-principal-architect.md	Adds Azure principal architect agent definition (devops-oncall plugin).
plugins/devops-oncall/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
plugins/dataverse/.github/plugin/plugin.json	Normalizes skills path formatting (removes trailing slash).
plugins/dataverse-sdk-for-python/skills/dataverse-python-usecase-builder/SKILL.md	Adds Dataverse Python use-case builder skill.
plugins/dataverse-sdk-for-python/skills/dataverse-python-quickstart/SKILL.md	Adds Dataverse Python quickstart skill.
plugins/dataverse-sdk-for-python/skills/dataverse-python-production-code/SKILL.md	Adds Dataverse Python production-code skill.
plugins/dataverse-sdk-for-python/skills/dataverse-python-advanced-patterns/SKILL.md	Adds Dataverse Python advanced patterns skill.
plugins/dataverse-sdk-for-python/.github/plugin/plugin.json	Normalizes Dataverse Python skills paths in plugin manifest.
plugins/database-data-management/skills/postgresql-code-review/SKILL.md	Adds PostgreSQL-specific code review skill.
plugins/database-data-management/agents/postgresql-dba.md	Adds PostgreSQL DBA agent definition.
plugins/database-data-management/agents/ms-sql-dba.md	Adds MS-SQL DBA agent definition.
plugins/database-data-management/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
plugins/csharp-mcp-development/skills/csharp-mcp-server-generator/SKILL.md	Adds C# MCP server generator skill.
plugins/csharp-mcp-development/agents/csharp-mcp-expert.md	Adds C# MCP server expert agent definition.
plugins/csharp-mcp-development/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/csharp-dotnet-development/skills/dotnet-upgrade/SKILL.md	Adds .NET upgrade planning skill prompts.
plugins/csharp-dotnet-development/skills/dotnet-best-practices/SKILL.md	Adds .NET/C# best practices skill.
plugins/csharp-dotnet-development/skills/csharp-xunit/SKILL.md	Adds xUnit best practices skill.
plugins/csharp-dotnet-development/skills/csharp-tunit/SKILL.md	Adds TUnit best practices skill.
plugins/csharp-dotnet-development/skills/csharp-nunit/SKILL.md	Adds NUnit best practices skill.
plugins/csharp-dotnet-development/skills/csharp-async/SKILL.md	Adds C# async best practices skill.
plugins/csharp-dotnet-development/skills/aspnet-minimal-api-openapi/SKILL.md	Adds ASP.NET Minimal API + OpenAPI guidance skill.
plugins/csharp-dotnet-development/agents/expert-dotnet-software-engineer.md	Adds expert .NET software engineer agent definition.
plugins/csharp-dotnet-development/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
plugins/copilot-sdk/.github/plugin/plugin.json	Normalizes skills path formatting (removes trailing slash).
plugins/context-engineering/skills/what-context-needed/SKILL.md	Adds “what context needed” skill.
plugins/context-engineering/skills/refactor-plan/SKILL.md	Adds refactor planning skill.
plugins/context-engineering/skills/context-map/SKILL.md	Adds context mapping skill.
plugins/context-engineering/agents/context-architect.md	Adds context architect agent definition.
plugins/context-engineering/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
plugins/clojure-interactive-programming/skills/remember-interactive-programming/SKILL.md	Adds interactive programming reminder skill.
plugins/clojure-interactive-programming/agents/clojure-interactive-programming.md	Adds Clojure interactive programming agent definition.
plugins/clojure-interactive-programming/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills path.
plugins/cast-imaging/agents/cast-imaging-structural-quality-advisor.md	Adds CAST Imaging structural quality advisor agent definition.
plugins/cast-imaging/agents/cast-imaging-software-discovery.md	Adds CAST Imaging software discovery agent definition.
plugins/cast-imaging/agents/cast-imaging-impact-analysis.md	Adds CAST Imaging impact analysis agent definition.
plugins/cast-imaging/.github/plugin/plugin.json	Changes CAST Imaging plugin agent registration to reference the agents directory.
plugins/azure-cloud-development/skills/azure-pricing/references/SERVICE-NAMES.md	Adds Azure pricing “serviceName” reference doc.
plugins/azure-cloud-development/skills/azure-pricing/references/REGIONS.md	Adds Azure pricing region reference doc.
plugins/azure-cloud-development/skills/azure-pricing/references/COST-ESTIMATOR.md	Adds Azure cost estimation formulas reference doc.
plugins/azure-cloud-development/skills/azure-pricing/references/COPILOT-STUDIO-RATES.md	Adds Copilot Studio billing rates + estimation reference doc.
plugins/azure-cloud-development/agents/terraform-azure-planning.md	Adds Azure Terraform planning agent definition.
plugins/azure-cloud-development/agents/terraform-azure-implement.md	Adds Azure Terraform implementation agent definition.
plugins/azure-cloud-development/agents/azure-verified-modules-terraform.md	Adds AVM Terraform agent definition.
plugins/azure-cloud-development/agents/azure-verified-modules-bicep.md	Adds AVM Bicep agent definition.
plugins/azure-cloud-development/agents/azure-saas-architect.md	Adds Azure SaaS architect agent definition.
plugins/azure-cloud-development/agents/azure-principal-architect.md	Adds Azure principal architect agent definition (azure-cloud-development plugin).
plugins/azure-cloud-development/agents/azure-logic-apps-expert.md	Adds Azure Logic Apps expert agent definition.
plugins/azure-cloud-development/.github/plugin/plugin.json	Changes Azure cloud plugin agent registration to reference the agents directory + normalizes skills paths.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-skills/SKILL.md	Adds skill for suggesting awesome-copilot skills.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-prompts/SKILL.md	Adds skill for suggesting awesome-copilot prompts.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-instructions/SKILL.md	Adds skill for suggesting awesome-copilot instructions.
plugins/awesome-copilot/skills/suggest-awesome-github-copilot-agents/SKILL.md	Adds skill for suggesting awesome-copilot agents.
plugins/awesome-copilot/agents/meta-agentic-project-scaffold.md	Adds meta agent for scaffolding by pulling assets from awesome-copilot.
plugins/awesome-copilot/.github/plugin/plugin.json	Updates manifest to reference agents directory + normalizes skills paths.
docs/README.instructions.md	Adds README entry for Cloud Design Patterns instruction file.

[Copilot]

The instructions reference a learning_path_server tool, but the only tools declared in this agent’s mcp-servers block are skopeo, check_image, knowledge_base_search, migrate_ease_scan, mcp, and sysreport_instructions. Update these steps to use an actually-available tool (e.g., knowledge_base_search) or add the missing tool to the server’s tool list so the workflow is executable.

Suggested change

	- Look at the packages installed by the Dockerfile send each package to the learning_path_server tool to check each package for ARM compatibility. If a package is not compatible, change it to a compatible version. When invoking the tool, explicitly ask "Is [package] compatible with ARM architecture?" where [package] is the name of the package.
	- Look at the contents of any requirements.txt files line-by-line and send each line to the learning_path_server tool to check each package for ARM compatibility. If a package is not compatible, change it to a compatible version. When invoking the tool, explicitly ask "Is [package] compatible with ARM architecture?" where [package] is the name of the package.
	- Look at the packages installed by the Dockerfile and send each package to the knowledge_base_search tool to check each package for ARM compatibility. If a package is not compatible, change it to a compatible version. When invoking the tool, explicitly ask "Is [package] compatible with ARM architecture?" where [package] is the name of the package.
	- Look at the contents of any requirements.txt files line-by-line and send each line to the knowledge_base_search tool to check each package for ARM compatibility. If a package is not compatible, change it to a compatible version. When invoking the tool, explicitly ask "Is [package] compatible with ARM architecture?" where [package] is the name of the package.

[Copilot]

This agent claims it uses 'Amplitude's MCP tools' but the front matter does not declare any tools: nor any mcp-servers: configuration. As written, the agent cannot actually invoke Amplitude tooling. Add the required tools entries and MCP server configuration (or adjust the description/instructions to match the actual execution environment).

Suggested change

	description: This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features.
	description: This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features.
	model: gpt-4.1
	tools:
	- amplitude-experiment
	mcp-servers:
	amplitude-experiment:
	command: amplitude-experiment-mcp

[Copilot]

This README entry links to ../instructions/cloud-design-patterns.instructions.md, but that instruction file is not included in the provided diffs. If the file isn’t actually being added in this PR, the link (and install buttons) will be broken—either add the instruction file to the PR or remove/adjust this README entry.

Suggested change

	| [Cloud Design Patterns](../instructions/cloud-design-patterns.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcloud-design-patterns.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcloud-design-patterns.instructions.md) | Cloud Design Patterns for distributed systems architecture |
	| [Cmake Vcpkg](../instructions/cmake-vcpkg.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md) | C++ project configuration and package management |
	| [Code Components](../instructions/pcf-code-components.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md) | Understanding code components structure and implementation |
	| [Cmake Vcpkg](../instructions/cmake-vcpkg.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md) | C++ project configuration and package management |
	| [Code Components](../instructions/pcf-code-components.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md) | Understanding code components structure and implementation |
	| [Code Components](../instructions/pcf-code-components.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md) | Understanding code components structure and implementation |

[Copilot]

Multiple plugin manifests change agents from an explicit list of agent files to a directory reference (\"./agents\"). If the plugin loader expects file paths (as previously configured), this becomes a breaking change and agents may no longer be discoverable. Consider keeping explicit file entries, or (if directory expansion is supported) update/confirm the plugin schema + implementation to clearly document that agents and skills accept directories.

[aaronpowell]

It looks like you've incorrectly branched from the main branch not staged, and as a result all the materialised plugins are included in this PR.

You can attempt to fix this with a rebase:

git fetch origin staged
git rebase --onto origin/staged origin/main <branch name>
git push --force-with-lease

If that does not resolve it, you can run npm run plugin:clean which will delete the materialised plugins and you can commit that change.

[fatihdurgut]

I'll re-create in another pull request