.NET Engineering

Use this skill as the default engineering guide for modern .NET work. It provides general .NET engineering principles, task classification, reference routing, dependency decisions, and validation. Repository-specific instructions, established conventions, and explicit task requirements take precedence.

Core principles

• Understand the repository before changing it.
• Prefer the simplest correct solution that satisfies the requirement.
• Preserve existing project conventions unless there is a concrete reason to change them.
• Prefer framework/platform capabilities before introducing custom infrastructure.
• Minimize unnecessary dependencies, not dependencies at all costs.
• Do not add a third-party dependency merely because a library exists.
• Do not implement security-sensitive primitives yourself merely to avoid a dependency.
• Prefer explicit behavior over magic, hidden conventions, and unnecessary abstraction.
• Optimize for correctness, maintainability, observability, and performance together.
• Measure performance before making optimization claims.
• Make surgical changes; avoid unrelated refactoring.

Instruction precedence