LLM 없이 코드 아키텍처를 1초 만에 분석하는 결정론적 엔진

섹션별 상세

LLM과 클라우드 자원을 전혀 사용하지 않고 로컬 노트북 환경에서 작동하는 결정론적 아키텍처 분석 엔진이다. 4개 언어로 작성된 6개의 실제 프로젝트에서 45,000개 이상의 함수를 대상으로 성능을 검증했으며, GPU나 복잡한 설정 없이 즉각적인 분석 결과를 제공한다.

단순한 호출 관계를 넘어 소유권, 주입, 약한 참조, 순환 참조 등 17,505개의 정적 타입 의존성을 정밀하게 매핑한다. 이를 통해 시스템의 실제 오케스트레이션 구조와 상태가 유지되는 위치, 그리고 모듈 간의 경계를 명확히 식별한다.

Express.js 프로젝트 분석 결과, 551ms라는 짧은 시간 내에 25개의 아키텍처 블록과 498개의 아키텍처 스멜을 찾아냈다. 특히 app과 router 객체가 너무 많은 의존성을 가진 God Class라는 점과, 이들 사이의 고질적인 순환 의존성 문제를 정확히 탐지했다.

분석 결과는 100% 분류 합의를 이루며 모호함이 전혀 없는 결정론적 특성을 가진다. 이는 LLM 기반 도구들이 흔히 겪는 자신감 있는 환각 문제를 해결하며, 모든 분석 결정에 대해 명확한 근거를 제시할 수 있다.

용어 해설

순환 의존성(Circular Dependency): — 둘 이상의 모듈이 서로를 참조하여 고리를 형성하는 구조이다. 시스템의 결합도를 높여 특정 모듈의 수정이 예기치 못한 연쇄 오류를 일으키게 하며, 코드의 재사용성과 테스트 용이성을 심각하게 저하시키는 아키텍처 결함으로 간주된다.
갓 클래스(God Class): — 하나의 객체가 시스템의 너무 많은 기능을 담당하고 과도한 의존성을 가지는 설계 안티 패턴이다. 모든 로직이 한곳에 집중되어 코드 파악이 어렵고, 작은 변경에도 전체 시스템이 영향을 받게 되어 유지보수 비용을 기하급수적으로 증가시킨다.
결정론적(Deterministic): — 동일한 입력에 대해 항상 동일한 결과를 출력하는 성질을 의미한다. 확률에 기반하여 매번 결과가 달라질 수 있는 LLM과 달리, 정적 분석 엔진은 명확한 규칙에 따라 작동하므로 분석 결과의 신뢰성과 재현성을 보장한다.
아키텍처 스멜(Architectural Smell): — 코드 수준의 문제를 넘어 시스템 전체 구조에서 발견되는 설계상의 결함이나 잠재적 위험 신호이다. 이는 당장 오류를 일으키지는 않지만, 향후 시스템의 확장성을 저해하고 기술적 부채를 쌓이게 만드는 근본적인 원인이 된다.
횡단 관심사(Cross-cutting Concern): — 로깅, 보안, 트랜잭션 관리와 같이 여러 비즈니스 모듈에 공통적으로 흩어져서 나타나는 기능을 뜻한다. 이를 아키텍처적으로 분리하지 못하면 코드 중복이 발생하고 핵심 비즈니스 로직의 응집도가 떨어진다.

기술

Express.js

활용 사례

Legacy Code Analysis
Architecture Auditing
Refactoring Planning