Dotnet Architecture

.NET Architecture

Design patterns and architectural guidance for building scalable, maintainable .NET applications. This meta-skill provides navigation to ~15 architecture-focused skills covering vertical slices, domain modeling, messaging, resilience, and system design.

When to Use This Skill

Load this skill when:

• Designing application architecture and structure
• Implementing domain-driven design patterns
• Setting up messaging and event-driven systems
• Adding resilience patterns (retry, circuit breaker)
• Choosing between architectural approaches

Quick Navigation

Core Patterns

Messaging & Events

Resilience & Reliability

Infrastructure

API Design

Modern Platforms

Architectural Decision Trees

Which Architecture Pattern?

Simple CRUD API → Minimal APIs (dotnet-minimal-apis)
        ↓
Complex Business Logic → Vertical Slices (dotnet-architecture-patterns)
        ↓
Distributed System → Aspire (dotnet-aspire-patterns)
        ↓
Event-Driven → Messaging Patterns (dotnet-messaging-patterns)

Which Resilience Pattern?

Which Communication Style?

Complete Skill List

Core Architecture (5 skills)

• dotnet-architecture-patterns - Vertical slices, pipelines, caching
• dotnet-domain-modeling - DDD, aggregates, value objects
• dotnet-solid-principles - SOLID/DRY principles
• dotnet-middleware-patterns - ASP.NET Core middleware
• dotnet-minimal-apis - Minimal API patterns

Messaging & Events (4 skills)

• dotnet-messaging-patterns - Pub/sub, competing consumers
• dotnet-channels - Channel, backpressure
• dotnet-realtime-communication - SignalR, SSE, gRPC streaming
• dotnet-service-communication - Protocol decisions

Resilience (2 skills)

• dotnet-resilience - Polly v8, patterns
• dotnet-background-services - IHostedService

Observability (3 skills)

• dotnet-observability - OpenTelemetry
• dotnet-structured-logging - Log pipelines
• dotnet-api-versioning - API versioning

Modern Platforms (3 skills)

• dotnet-aspire-patterns - Distributed apps
• dotnet-grpc - gRPC services
• dotnet-resilience - Fault tolerance

Cross-References

• Web Development → dotnet-web meta-skill
• Data Access → dotnet-data meta-skill
• Performance → dotnet-performance meta-skill
• Security → dotnet-security meta-skill
• Fundamentals → dotnet-fundamentals meta-skill

Architectural Styles Covered

Vertical Slice Architecture

• Feature-based organization
• Self-contained slices
• Reduced cross-feature coupling

Domain-Driven Design

• Aggregate boundaries
• Value objects
• Domain events
• Repository patterns

Event-Driven Architecture

• Pub/sub messaging
• Competing consumers
• Dead letter queues
• Saga patterns

Resilience Patterns

• Retry with exponential backoff
• Circuit breaker
• Timeout and bulkhead
• Idempotency keys

Version Assumptions

• .NET 8.0+ for most patterns
• Aspire requires .NET 8.0+
• gRPC requires .NET 6.0+
• HybridCache requires .NET 8.0+

See Also

• INDEX.md - Complete skill index
• TAXONOMY.md - Taxonomy schema