복잡한 코드베이스를 마주한 개발자는 파일 간의 의존성과 함수 호출 관계를 파악하는 데 상당한 시간을 소모한다. 최근 공개된 Understand-Anything(코드와 지식 베이스를 인터랙티브 그래프로 변환하는 도구)은 이러한 구조적 파악의 어려움을 해결하기 위해 멀티 에이전트 파이프라인을 도입했다. 이 도구는 프로젝트 내 모든 파일, 함수, 클래스, 의존성을 자동으로 분석해 시각적인 지식 그래프로 구현한다.

Understand-Anything의 핵심 기능과 작동 방식

이 플러그인은 프로젝트 분석을 위해 /understand 명령어를 사용하며, 분석된 결과는 /understand-dashboard를 통해 웹 기반 대시보드에서 확인할 수 있다. 시스템은 크게 두 가지 뷰를 제공한다. 파일, 함수, 클래스를 노드로 표현하는 구조적 그래프와 비즈니스 프로세스를 매핑하는 도메인 그래프다. 아키텍처 레이어별로 색상을 구분해 가독성을 높였으며, 특정 노드를 클릭하면 해당 요소의 평문 요약과 관계 정보를 즉시 확인할 수 있다.

데이터 분석을 위해 7개의 전문 에이전트가 가동된다. project-scanner(프로젝트 스캔), file-analyzer(파일 분석), architecture-analyzer(아키텍처 분석), tour-builder(가이드 투어 생성), graph-reviewer(그래프 검토) 등 5개의 기본 에이전트와 도메인 및 위키 분석을 담당하는 2개의 에이전트가 협업한다. 파일 분석기는 최대 5개를 동시에 실행할 수 있으며, 배치당 20에서 30개의 파일을 처리한다. 증분 업데이트를 지원해 변경된 부분만 효율적으로 반영한다.

기존 코드 분석 도구와의 차이점

예전에는 개발자가 직접 문서를 작성하거나 정적 분석 도구(코드 실행 없이 구조를 파악하는 도구)에 의존해 코드의 맥락을 파악해야 했다. 이제는 /understand-knowledge 명령어를 통해 Karpathy 패턴(LLM을 활용한 지식 관리 방법론) 기반의 위키를 분석하고, LLM 에이전트가 암묵적 관계와 엔티티를 추출해 포스 디렉티드 그래프(노드 간 인력을 계산해 배치하는 그래프)로 변환한다. 단순히 이름으로 검색하는 방식에서 벗어나 의미 기반의 퍼지 및 시맨틱 검색을 지원하는 점이 가장 큰 차이다.

또한 /understand-diff 명령어를 사용하면 커밋 전 변경 사항이 전체 코드베이스에 미치는 영향(리플 이펙트)을 사전에 파악할 수 있다. 12개의 프로그래밍 패턴(제네릭, 클로저, 데코레이터 등)을 코드 내 위치와 맥락에 맞춰 설명해주며, 주니어 개발자부터 PM, 파워 유저까지 페르소나에 맞춰 대시보드 상세 수준을 자동으로 조정한다. 생성된 지식 그래프는 JSON 형식으로 저장되어 팀원 간 공유가 가능하며, --auto-update 옵션을 사용하면 커밋 시마다 그래프를 자동 동기화할 수 있다.

개발 환경에 미치는 영향

개발자가 바로 체감하는 변화는 코드베이스 학습 속도의 향상이다. 의존성 순서로 정렬된 아키텍처 워크스루를 생성하는 가이드 투어 기능은 신규 프로젝트 투입 시 학습 시간을 단축한다. 현재 Claude Code(Anthropic의 AI 코딩 도구), Codex(OpenAI의 코드 생성 모델), Cursor(AI 기반 코드 에디터), Copilot(GitHub의 AI 코딩 보조 도구), Gemini CLI(Google의 명령줄 인터페이스), OpenCode(오픈소스 코드 분석 도구), Pi Agent(개인용 AI 에이전트) 등 10개 이상의 AI 코딩 플랫폼을 지원한다. MIT 라이선스로 배포되는 이 도구는 GitHub 저장소에서 상세 내용을 확인할 수 있다.

코드의 구조적 가시성을 확보하는 것은 단순한 시각화를 넘어 AI 에이전트가 프로젝트 전체 맥락을 이해하는 기반이 된다.