agents/plugins/dotnet-contribution/README.md

.NET Backend Development Plugin

A comprehensive plugin for .NET backend development with C#, ASP.NET Core, Entity Framework Core, and Dapper.

Overview

This plugin provides agents, skills, and patterns for building production-grade .NET applications. It focuses on modern C# (12/13), ASP.NET Core 8+, and enterprise development patterns.

Contents

Agents

Agent	Model	Description
dotnet-architect	Sonnet	Expert .NET architect for API development, code review, and architecture decisions

Skills

Skill	Description
dotnet-backend-patterns	Comprehensive patterns for services, repositories, DI, caching, and testing

Assets

• service-template.cs - Complete service implementation with Result pattern, validation, caching
• repository-template.cs - Repository implementations with Dapper and EF Core

References

• ef-core-best-practices.md - EF Core optimization guide
• dapper-patterns.md - Advanced Dapper usage patterns

Usage

With Claude Code CLI

# General .NET architecture help
claude -p "Act as dotnet-architect and design a caching strategy for my product catalog"

# Code review
claude -p "Act as dotnet-architect and review this async code for issues"

# Implementation help
claude -p "Use dotnet-backend-patterns skill to implement a repository with Dapper"

Example Prompts

1. API Design

   Act as dotnet-architect. Design a REST API for order management with proper 
   DTOs, validation, and error handling.
   

2. Performance Review

   Act as dotnet-architect. Review this EF Core query for N+1 problems and 
   suggest optimizations.
   

3. Architecture Decision

   Act as dotnet-architect. Should I use EF Core or Dapper for this high-throughput 
   read scenario? Explain trade-offs.
   

Topics Covered

C# Language

• Async/await patterns and pitfalls
• LINQ optimization
• Records and immutability
• Pattern matching
• Nullable reference types
• Memory-efficient programming

ASP.NET Core

• Minimal APIs and Controllers
• Dependency Injection (Scoped, Singleton, Transient, Keyed)
• Configuration with IOptions
• Middleware pipeline
• Authentication/Authorization
• Health checks

Data Access

• Entity Framework Core best practices
• Dapper for high-performance queries
• Repository pattern
• Unit of Work
• Connection management
• Transaction handling

Caching

• IMemoryCache
• IDistributedCache with Redis
• Multi-level caching
• Cache invalidation
• Distributed locking

Testing

• xUnit fundamentals
• Moq for mocking
• Integration tests with WebApplicationFactory
• Test patterns and best practices

Stack Compatibility

Technology	Version
.NET	8.0+
C#	12+
ASP.NET Core	8.0+
Entity Framework Core	8.0+
SQL Server	2019+
Redis	6.0+

Contributing

Contributions welcome! Please ensure:

• Code examples compile and follow C# conventions
• Patterns are production-tested
• Documentation is clear and includes examples

License

MIT License - See repository root for details.