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-guide
3description: |
4 Microsoft .NET Microservices Architecture Guide reference.
5 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.
6 Provides: chapter-by-chapter summary, code patterns from eShopOnContainers, decision matrices for sync vs async integration, and links into specific guide sections.
7metadata:
8 source: https://skillmd.com/skills/josiahsiegel/microsoft-guide
9---
10
11# Microsoft .NET Microservices Architecture Guide (v7.0)
12
13This 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).
14
15## When to Use This Skill
16
17Invoke this skill when you need:
18- **Detailed technical information** from the official Microsoft guide
19- **Specific implementation patterns** or code examples
20- **In-depth explanations** beyond your summarized knowledge
21- **Official Microsoft recommendations** for microservices architecture
22- **Reference to eShopOnContainers** implementation details
23- **Comprehensive coverage** of specific topics (DDD, CQRS, Docker, Kubernetes, etc.)
24
25## What This Skill Contains
26
27The complete 350-page Microsoft guide (text content only) including:
28- Container fundamentals and Docker concepts
29- Choosing between .NET and .NET Framework
30- Microservices architecture principles
31- API Gateway patterns
32- Event-driven architecture
33- Domain-Driven Design (DDD) tactical and strategic patterns
34- CQRS (Command Query Responsibility Segregation)
35- Data management in microservices
36- Resilience patterns (Circuit Breaker, Retry, Bulkhead)
37- Security best practices
38- Kubernetes and orchestration
39- eShopOnContainers reference application details
40- Complete code examples and implementation guidance
41- All architectural concepts explained in text (diagrams removed for size optimization)
42
43## How to Use
44
45When a user asks about:
461. Specific technical details you need to verify
472. Code implementation examples
483. eShopOnContainers architecture details
494. Official Microsoft recommendations
505. Complex patterns requiring detailed explanations
51
52Invoke this skill and follow the procedure below.
53
54## Core Procedure
55
561. Restate the architecture decision or implementation question in concrete terms: boundary, service, data ownership, deployment target, and failure mode.
572. Search the guide for the relevant pattern rather than relying on memory alone.
583. Separate Microsoft guide recommendations from project-specific constraints or newer platform guidance.
594. Prefer decision matrices over one-size-fits-all answers for sync vs async calls, gateway placement, data ownership, and deployment topology.
605. 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.
616. Call out trade-offs: autonomy vs consistency, latency vs resilience, operational simplicity vs scalability.
62
63## Quick Pattern Map
64
65| User intent | Guide area to inspect |
66|---|---|
67| Define service boundaries | DDD, bounded contexts, data ownership |
68| Choose HTTP vs messaging | Communication in microservices, integration events |
69| Add API gateway | API Gateway patterns, Ocelot/YARP considerations |
70| Improve resilience | Retry, circuit breaker, timeout, health checks, Polly |
71| Split databases | Data sovereignty, eventual consistency, CQRS |
72| Deploy containers | Docker, Kubernetes, orchestrators, environment configuration |
73
74---
75
76## Full Microsoft Guide Content
77
78The complete guide is available in this skill directory at:
79`NET-Microservices-Architecture.md`
80
81When 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.
82
83## Usage Instructions
84
85When this skill is invoked:
861. Read the NET-Microservices-Architecture.md file in this directory
872. Use Grep to search for specific topics the user is asking about
883. Provide detailed, accurate answers based on the official Microsoft guide content
894. Reference specific sections and code examples from the guide
905. Cite the guide as the source of information
91
92**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).