새 팀 코드를 지도로 바꿔 이해와 공유를 돕는 도구
20만 줄짜리 코드베이스를 처음 마주했을 때, 어디서부터 읽어야 할지 막막했던 경험이 있다면 이 도구가 답이 됩니다. 코드의 모든 파일과 함수, 의존성을 상호작용 가능한 지식 그래프로 변환해 시각적으로 탐색하고 질문할 수 있게 해주는 도구입니다. 단순히 구조를 보여주는 것을 넘어, 비즈니스 로직과 아키텍처 계층까지 연결해 코드 전체가 어떻게 맞물려 돌아가는지 이해하는 시간을 단축시킵니다.
코드 구조를 지도처럼 탐색하다
이 도구는 프로젝트의 모든 파일, 함수, 클래스를 노드로 만들어 인터랙티브 대시보드에 표시합니다. 노드를 클릭하면 해당 코드의 평이한 설명과 관계, 그리고 학습 순서가 정해진 가이드 투어를 볼 수 있습니다. 아키텍처 계층(API, 서비스, 데이터 등)에 따라 색상으로 구분되어 시스템의 계층 구조를 직관적으로 파악할 수 있습니다. 또한 '인증 처리는 어디에 있나요?'처럼 의미 기반 검색을 통해 특정 기능을 담당하는 코드 조각을 빠르게 찾을 수 있습니다.
비즈니스 로직과 지식 베이스까지 연결
코드 구조를 넘어 실제 비즈니스 프로세스와 어떻게 대응하는지 보여주는 도메인 뷰를 제공합니다. 도메인, 플로우, 단계를 수평 그래프로 배치해 코드와 업무 로직의 매핑을 시각화합니다. 카르파티 패턴의 LLM 위키를 분석하면 위키링크와 카테고리를 추출하고, 암묵적인 관계와 실체를 발견해 상호 연결된 아이디어의 그래프로 변환합니다. 이는 문서화된 지식 베이스를 탐색 가능한 지식 그래프로 바꾸는 과정입니다.
다양한 AI 코딩 플랫폼에서 동작
Claude Code, Codex, Cursor, Copilot, Gemini CLI 등 다양한 AI 코딩 플랫폼에서 사용할 수 있습니다. Claude Code는 플러그인 마켓플레이스를 통해 설치하며, 다른 플랫폼은 설치 스크립트를 실행하거나 리포지토리를 클론하여 자동 감지됩니다. 각 플랫폼에 맞는 호출 방식(슬래시 명령어 등)을 지원하며, 로컬 모델(Ollama 등)을 지정해 프라이버시나 엔터프라이즈 환경에서도 사용할 수 있습니다. 설치 후 /understand 명령어로 분석을 시작하면, 변경된 파일만 재분석하는 증분 업데이트를 기본으로 지원합니다.
팀 공유와 대시보드 활용
생성된 그래프는 JSON 파일로 저장되어 팀원 간 공유가 쉽습니다. .ua/ 디렉토리를 커밋하면 다른 팀원은 파이프라인 실행 없이 대시보드를 열람할 수 있어 온보딩이나 PR 리뷰에 유용합니다. Claude Code나 LLM 없이도 Node.js만 있으면 로컬에서 대시보드를 열람할 수 있으며, 모든 데이터는 로컬 디스크에서 읽기 전용으로 제공되어 외부로 전송되지 않습니다. 커밋 시마다 그래프를 자동으로 업데이트하는 훅을 설정해 코드와 그래프의 일관성을 유지할 수 있습니다.
사용 전 확인해야 할 점
초기 분석 시 전체 코드베이스를 스캔하므로 대규모 프로젝트에서는 상당한 토큰 소모가 발생할 수 있습니다. 이를 고려해 토큰 구독 플랜이나 로컬 모델을 사용하는 것을 권장합니다. 구조적 분석은 Tree-sitter를 사용해 결정론적으로 처리되므로 동일한 코드는 항상 동일한 결과를 내며, 의미 분석은 LLM이 담당합니다. MIT 라이선스로 공개되어 있으며, Node.js 18 이상 환경에서 로컬 뷰어를 실행할 수 있습니다. 복잡한 모노레포의 경우 특정 하위 디렉토리로 범위를 좁혀 분석하는 옵션도 제공합니다.