dotnet-claude-code-skills

This collection of skills provides production-grade architectural patterns and automation workflows for .NET developers. It is designed to assist in building maintainable, testable applications by adhering to Domain-Driven Design (DDD) principles, hexagonal architecture, and robust data persistence strategies. Whether you are defining aggregate roots, implementing command/query handlers, or configuring complex EF Core migrations, these skills offer templates and methodologies to standardize your code quality.

The library includes specialized support for BDD-style unit testing. By utilizing a hybrid approach—integrating real repository implementations with EF Core InMemory databases and custom fakes—developers can move beyond brittle mocks to achieve realistic test scenarios. It covers the setup of TestDataBuilder, TestContextFactory, and fluent aggregate builders to streamline your test infrastructure.

Additionally, this repository includes an integration guide for Serena MCP, which brings IDE-like semantic code understanding directly into your Claude Code workflow. This feature enables symbol-level navigation, intelligent editing, and multi-project context management, allowing for high-precision refactoring and project-wide search capabilities.

• Core DDD patterns: Implementing IDomainObject, IAggregate, CQRS separation using Paramore.Brighter, and Unit of Work patterns.

• Data persistence: Configuring EF Core, repository implementations, multi-schema organization, and DI auto-registration.

• Testing framework: BDD-style Arrange-Act-Assert testing, custom FakeClock/FakeUnitOfWork, and complex scenario testing with CSV files.

• Serena MCP integration: Setting up per-project .mcp.json files for project-aware semantic understanding and symbol-level code manipulation.

• Use these skills when scaffolding new projects to enforce consistent architectural boundaries and patterns.

• Ideal for senior engineers and architects performing code reviews or setting up Domain-Shared projects.

• Follow the provided templates for command/query handlers and entity configurations to reduce boilerplate code.

• The testing skills are best utilized during the TDD cycle; define your domain behavior in tests before writing the implementation logic.

• Ensure each project has an independent .mcp.json file when using the Serena skill to maintain complete isolation between different codebases.

• The patterns assume C# and .NET environments, but the core hexagonal architecture concepts are applicable to any object-oriented system.