CLAUDE.md 가이드라인을 통한 AI 생성 Scala 코드 버그 80% 제거

Context

AI 모델이 Java 스타일의 레거시 Scala 코드에 편향되어 Option 대신 null을 사용하거나 Mutable 상태를 남용하는 현상 발생. 특히 cats-effect나 ZIO 같은 현대적 FP 스택을 사용하는 환경에서 AI가 생성한 비정형 코드가 런타임 NPE 및 Race Condition을 유발하는 한계점 노출.

Technical Solution

• null 배제 및 Type-level Absence 도입을 통한 컴파일 타임 안정성 확보
• Mutable 상태 제어를 위해 var 사용을 금지하고 Ref[IO, A] 기반의 원자적 상태 관리 구조 채택
• Data 모델링 시 class 대신 case class와 Scala 3 enum을 활용한 ADT(Algebraic Data Types) 설계로 패턴 매칭 강제
• try-catch 기반의 포괄적 예외 처리 대신 Either를 통한 Typed Error 처리 체계 구축
• -Werror 옵션을 포함한 엄격한 scalac 설정으로 경고 수준의 코드를 빌드 에러로 승격시켜 품질 게이트 구축
• CLAUDE.md 파일을 통한 AI 컨텍스트 주입으로 프로젝트 특화 Idiomatic Functional Code 생성 유도