Cursor Rules 기반 .NET 8 Worker Service 표준 아키텍처 자동화

Building Better .NET Worker Services with Cursor Rules

burak2026년 5월 25일2분intermediate

AI 요약

Context

AI 생성 코드의 단순 데모 수준 한계로 인한 운영 환경 적용의 어려움 발생. 일관된 엔지니어링 컨벤션 부재에 따른 코드 파편화와 배포 설정 누락 문제 해결 필요.

Clean Architecture 및 SOLID 원칙 적용을 통한 Domain과 Infrastructure 계층의 물리적 분리
BackgroundService 패턴 기반의 비동기 처리 구조와 CancellationToken 전파를 통한 Graceful Shutdown 구현
Polly 라이브러리를 활용한 외부 서비스 호출 Retry Policy 적용으로 시스템 회복력 확보
IOptions 패턴 및 IConfiguration 연동을 통한 환경별 설정 관리의 유연성 증대
Multi-stage Docker build 정의를 통한 빌드 환경 분리 및 런타임 이미지 최적화
Serilog 기반의 Structured Logging 체계 구축으로 런타임 가시성 및 에러 추적 효율화

실천 포인트

1. AI 코딩 도구에 단순 프롬프트가 아닌 Engineering Convention을 Rule set으로 주입했는가

2. Dockerfile과 .dockerignore를 프로젝트 완료 조건에 명시하여 배포 가능성을 확보했는가

3. 비즈니스 로직이 Worker.cs에 직접 포함되지 않고 Application/Domain 계층으로 분리되었는가

4. 모든 외부 호출 지점에 Polly 기반의 Retry 전략과 적절한 Timeout 설정이 포함되었는가

태그