dotnet-coding-standards

.NET Coding Standards - 통합 패키지

포함 파일

dotnet-coding-standards/
├── SKILL.md                              # 이 파일 (상세 코드 예시)
├── references/                           # 핵심 규칙 (명시적 로드)
│   └── rules.md                          # 스킬 호출 시 읽는 규칙 본문
└── templates/                            # 코드 템플릿 (on-demand)
    ├── csharp-patterns.md                # Record DTO, Result, Pattern Matching, xUnit
    ├── aspnet-core.md                    # Program.cs, Minimal API, 미들웨어, JWT, Health
    └── efcore-patterns.md               # DbContext, DDD Entity, N+1, Migration, Audit

---

참조 로딩 규칙

1. 이 SKILL.md를 워크플로와 예시의 소유자로 사용합니다.
2. 스킬을 명시적으로 호출했을 때 references/rules.md를 읽고 현재 프로젝트에 필요한 규칙만 적용합니다.
3. C# 일반 패턴, ASP.NET Core, EF Core 중 요청과 맞는 templates/ 파일만 추가로 읽습니다.

이 규칙 본문은 스킬 안의 참조 문서이며 커스텀 에이전트로 등록되지 않습니다.

---

Clean Architecture 코드 예시

Program.cs (최소 설정)

var builder = WebApplication.CreateBuilder(args);

// 서비스 등록 (Extension Method로 정리)
builder.Services.AddApplicationServices();
builder.Services.AddInfrastructureServices(builder.Configuration);
builder.Services.AddApiServices();

var app = builder.Build();

// 미들웨어 파이프라인
app.UseExceptionHandler();
app.UseAuthentication();
app.UseAuthorization();

// 엔드포인트 매핑
app.MapControllers();
// 또는 Minimal API:
// app.MapItemEndpoints();

app.Run();

DI 등록 (Extension Methods)

// Application/Extensions/ServiceCollectionExtensions.cs
public static class ApplicationServiceExtensions
{
    public static IServiceCollection AddApplicationServices(this IServiceCollection services)
    {
        services.AddScoped<IItemService, ItemService>();
        services.AddScoped<IOrderService, OrderService>();
        services.AddValidatorsFromAssemblyContaining<ItemRequestValidator>();
        return services;
    }
}

// Infrastructure/Extensions/ServiceCollectionExtensions.cs
public static class InfrastructureServiceExtensions
{
    public static IServiceCollection AddInfrastructureServices(
        this IServiceCollection services, IConfiguration configuration)
    {
        services.AddDbContext<AppDbContext>(options =>
            options.UseSqlServer(configuration.GetConnectionString("Default")));

        services.AddScoped<IItemRepository, ItemRepository>();
        services.AddMemoryCache();
        return services;
    }
}