Roslyn 컴파일러 도구를 활용한 대규모 Unity 프로젝트용 AI 코딩 프레임워크 Lifeblood 공개

실용적 조언

대규모 C# 프로젝트를 관리한다면 Roslyn API를 활용해 AI가 참조할 수 있는 정확한 심볼 맵을 생성하라.
AI 도구 설계 시 포트와 어댑터 패턴을 사용하여 향후 새로운 모델이나 언어 분석기로의 교체가 용이하도록 설계하라.

섹션별 상세

대규모 코드베이스에서 단순 텍스트 검색(grep)의 한계를 극복하기 위해 컴파일러 수준의 분석을 도입했다. 기존 텍스트 기반 접근은 수백 개의 의존성을 반환하여 구조 파악을 어렵게 하지만, Roslyn 기반 분석은 실제 함수 체인과 심볼 사용처를 정확히 추적한다. 이를 통해 AI가 코드의 겉모습이 아닌 실제 작동 구조를 이해하고 리팩터링을 수행할 수 있는 환경을 조성했다.

프레임워크 설계에 헥사고날 아키텍처(포트와 어댑터)를 적용하여 확장성을 확보했다. 중앙의 프레임워크 로직을 고립시키고 왼쪽에는 Roslyn과 같은 컴파일러 솔루션을, 오른쪽에는 다양한 AI 커넥터를 연결할 수 있는 구조를 채택했다. 이러한 설계를 통해 특정 언어나 특정 AI 모델에 종속되지 않고 커뮤니티가 다양한 언어용 컴파일러 어댑터를 추가할 수 있는 기반을 마련했다.

실제 40만 라인 이상의 Unity 프로젝트에서 코드를 직접 실행하며 프레임워크의 유효성을 검증했다. Claude를 활용해 프레임워크를 구축했으며, 생성된 코드가 실제 대규모 프로젝트 환경에서 의도대로 작동함을 확인했다. 특히 비용이 많이 드는 연산 경로의 가치를 판단하거나 복잡한 리팩터링을 지원하는 등 실질적인 IDE 수준의 도구를 AI에게 부여하는 성과를 거뒀다.

용어 해설

로슬린(Roslyn): — Microsoft가 개발한 .NET 컴파일러 플랫폼으로, 컴파일 과정을 API로 노출하여 코드 분석, 리팩터링, 심볼 정보 추출 등을 가능하게 한다. 단순 텍스트 검색을 넘어 코드의 구문적, 의미적 구조를 정확히 파악할 수 있게 해주는 핵심 도구이다.
헥사고날 아키텍처(Hexagonal Architecture): — 애플리케이션의 핵심 로직을 외부 요소(DB, UI, 외부 API 등)로부터 분리하여 독립적으로 테스트하고 교체할 수 있게 설계하는 소프트웨어 구조이다. 포트와 어댑터 패턴을 사용하여 핵심 로직의 변경 없이 다양한 인터페이스를 연결할 수 있는 유연성을 제공한다.
심볼 사용(Symbol Usage): — 코드 내에서 변수, 함수, 클래스 등 식별자가 실제로 정의되고 참조되는 의미론적 관계를 의미한다. 단순 텍스트 일치가 아닌 컴파일러 수준의 분석을 통해 실제 의존성과 호출 체인을 정확히 추적할 수 있게 한다.

언급된 도구

Lifeblood추천링크

Roslyn 기반의 AI 코딩 컨텍스트 제공 프레임워크

Roslyn추천

C# 및 Visual Basic용 오픈소스 컴파일러 플랫폼

언급된 리소스

GitHubLifeblood GitHub Repository