csharp-coding-standards

What problem does it solve?

This Skill provides a cohesive, opinionated set of guidelines for writing modern, high-performance C# code to ensure consistency across teams.

Core Features & Use Cases

• Immutability by default using record types and init-only properties to model data safely.
• Value objects as readonly record structs with explicit conversions to preserve value semantics and performance.
• Modern pattern matching and API-design practices that emphasize composition over inheritance and clear boundaries.
• Async-first design with CancellationToken awareness, ValueTask usage where appropriate, and zero-allocation patterns via Span<T> and Memory<T>.

Quick Start

• Start by enabling nullable reference types and adopting records for DTOs and messages.
• Introduce readonly record structs for value objects, and replace mutable types with immutable equivalents.
• Apply composition-based designs (interfaces + small, focused components) over inheritance to build robust APIs.