Microsoft .NET Microservices Architecture Guide (v7.0)
This skill provides access to the complete official Microsoft guide: ".NET Microservices Architecture for Containerized .NET Applications" (Edition v7.0 - Updated to ASP.NET Core 7.0).
When to Use This Skill
Invoke this skill when you need:
- Detailed technical information from the official Microsoft guide
- Specific implementation patterns or code examples
- In-depth explanations beyond your summarized knowledge
- Official Microsoft recommendations for microservices architecture
- Reference to eShopOnContainers implementation details
- Comprehensive coverage of specific topics (DDD, CQRS, Docker, Kubernetes, etc.)
What This Skill Contains
The complete 350-page Microsoft guide (text content only) including:
- Container fundamentals and Docker concepts
- Choosing between .NET and .NET Framework
- Microservices architecture principles
- API Gateway patterns
- Event-driven architecture
- Domain-Driven Design (DDD) tactical and strategic patterns
- CQRS (Command Query Responsibility Segregation)
- Data management in microservices
- Resilience patterns (Circuit Breaker, Retry, Bulkhead)
- Security best practices
- Kubernetes and orchestration
- eShopOnContainers reference application details
- Complete code examples and implementation guidance
- All architectural concepts explained in text (diagrams removed for size optimization)
How to Use
When a user asks about:
- Specific technical details you need to verify
- Code implementation examples
- eShopOnContainers architecture details
- Official Microsoft recommendations
- Complex patterns requiring detailed explanations
Invoke this skill and follow the procedure below.
Core Procedure
- Restate the architecture decision or implementation question in concrete terms: boundary, service, data ownership, deployment target, and failure mode.
- Search the guide for the relevant pattern rather than relying on memory alone.
- Separate Microsoft guide recommendations from project-specific constraints or newer platform guidance.
- Prefer decision matrices over one-size-fits-all answers for sync vs async calls, gateway placement, data ownership, and deployment topology.
- When giving code or YAML, label it as a focused pattern excerpt and ask the implementation agent to adapt it to the user's runtime/version.
- Call out trade-offs: autonomy vs consistency, latency vs resilience, operational simplicity vs scalability.
Quick Pattern Map
| User intent |
Guide area to inspect |
| Define service boundaries |
DDD, bounded contexts, data ownership |
| Choose HTTP vs messaging |
Communication in microservices, integration events |
| Add API gateway |
API Gateway patterns, Ocelot/YARP considerations |
| Improve resilience |
Retry, circuit breaker, timeout, health checks, Polly |
| Split databases |
Data sovereignty, eventual consistency, CQRS |
| Deploy containers |
Docker, Kubernetes, orchestrators, environment configuration |
Full Microsoft Guide Content
The complete guide is available in this skill directory at:
NET-Microservices-Architecture.md
When you invoke this skill, you have access to read this file which contains the full 350-page Microsoft guide with all technical details, code examples, architecture patterns, and implementation guidance.
Usage Instructions
When this skill is invoked:
- Read the NET-Microservices-Architecture.md file in this directory
- Use Grep to search for specific topics the user is asking about
- Provide detailed, accurate answers based on the official Microsoft guide content
- Reference specific sections and code examples from the guide
- Cite the guide as the source of information
Note: The guide contains comprehensive text explanations of all concepts, patterns, and implementations. Image references have been removed to optimize plugin size (reduced from 18MB to ~800KB).
1---2name: microsoft-guide3description: Microsoft .NET Microservices Architecture Guide reference. PROACTIVELY activate for: (1) reading or applying patterns from Microsoft .NET Microservices Architecture for Containerized .NET Applications, (2) eShopOnContainers reference architecture, (3) DDD and bounded contexts, (4) integration events (RabbitMQ, Azure Service Bus), (5) API gateway patterns (Ocelot, YARP), (6) resilience patterns (Polly), (7) data patterns (CQRS, event sourcing), (8) testing strategies in microservices, (9) deployment to Kubernetes/AKS/Container Apps. Provides: chapter-by-chapter summary, code patterns from eShopOnContainers, decision matrices for sync vs async integration, and links into specific guide sections.4---5
6# Microsoft .NET Microservices Architecture Guide (v7.0)
7
8This skill provides access to the complete official Microsoft guide: ".NET Microservices Architecture for Containerized .NET Applications" (Edition v7.0 - Updated to ASP.NET Core 7.0).
9
10## When to Use This Skill
11
12Invoke this skill when you need:
13- **Detailed technical information** from the official Microsoft guide
14- **Specific implementation patterns** or code examples
15- **In-depth explanations** beyond your summarized knowledge
16- **Official Microsoft recommendations** for microservices architecture
17- **Reference to eShopOnContainers** implementation details
18- **Comprehensive coverage** of specific topics (DDD, CQRS, Docker, Kubernetes, etc.)
19
20## What This Skill Contains
21
22The complete 350-page Microsoft guide (text content only) including:
23- Container fundamentals and Docker concepts
24- Choosing between .NET and .NET Framework
25- Microservices architecture principles
26- API Gateway patterns
27- Event-driven architecture
28- Domain-Driven Design (DDD) tactical and strategic patterns
29- CQRS (Command Query Responsibility Segregation)
30- Data management in microservices
31- Resilience patterns (Circuit Breaker, Retry, Bulkhead)
32- Security best practices
33- Kubernetes and orchestration
34- eShopOnContainers reference application details
35- Complete code examples and implementation guidance
36- All architectural concepts explained in text (diagrams removed for size optimization)
37
38## How to Use
39
40When a user asks about:
411. Specific technical details you need to verify
422. Code implementation examples
433. eShopOnContainers architecture details
444. Official Microsoft recommendations
455. Complex patterns requiring detailed explanations
46
47Invoke this skill and follow the procedure below.
48
49## Core Procedure
50
511. Restate the architecture decision or implementation question in concrete terms: boundary, service, data ownership, deployment target, and failure mode.
522. Search the guide for the relevant pattern rather than relying on memory alone.
533. Separate Microsoft guide recommendations from project-specific constraints or newer platform guidance.
544. Prefer decision matrices over one-size-fits-all answers for sync vs async calls, gateway placement, data ownership, and deployment topology.
555. When giving code or YAML, label it as a focused pattern excerpt and ask the implementation agent to adapt it to the user's runtime/version.
566. Call out trade-offs: autonomy vs consistency, latency vs resilience, operational simplicity vs scalability.
57
58## Quick Pattern Map
59
60| User intent | Guide area to inspect |
61|---|---|
62| Define service boundaries | DDD, bounded contexts, data ownership |
63| Choose HTTP vs messaging | Communication in microservices, integration events |
64| Add API gateway | API Gateway patterns, Ocelot/YARP considerations |
65| Improve resilience | Retry, circuit breaker, timeout, health checks, Polly |
66| Split databases | Data sovereignty, eventual consistency, CQRS |
67| Deploy containers | Docker, Kubernetes, orchestrators, environment configuration |
68
69---
70
71## Full Microsoft Guide Content
72
73The complete guide is available in this skill directory at:
74`NET-Microservices-Architecture.md`
75
76When you invoke this skill, you have access to read this file which contains the full 350-page Microsoft guide with all technical details, code examples, architecture patterns, and implementation guidance.
77
78## Usage Instructions
79
80When this skill is invoked:
811. Read the NET-Microservices-Architecture.md file in this directory
822. Use Grep to search for specific topics the user is asking about
833. Provide detailed, accurate answers based on the official Microsoft guide content
844. Reference specific sections and code examples from the guide
855. Cite the guide as the source of information
86
87**Note**: The guide contains comprehensive text explanations of all concepts, patterns, and implementations. Image references have been removed to optimize plugin size (reduced from 18MB to ~800KB).
josiahsiegel