Understand Anything: 코드베이스를 지식 그래프로 바꾸는 AI 탐색 도구

대규모 코드베이스에 처음 들어가는 순간, 개발자는 보통 파일 트리와 검색창 앞에서 길을 잃는다. Understand Anything은 그 문제를 ‘읽어야 할 코드 목록’이 아니라 ‘탐색 가능한 지식 그래프’로 바꿔보려는 오픈소스 프로젝트다.

무엇을 하는 프로젝트인가

Understand Anything은 코드베이스, 지식 베이스, 문서를 인터랙티브 지식 그래프로 변환한다. README 기준으로 핵심 목표는 사용자가 그래프를 탐색하고, 검색하고, 질문하면서 프로젝트의 전체 구조를 이해하도록 돕는 것이다.

단순히 멋진 시각화를 보여주는 데서 끝나지 않는다. 저장소 설명은 ‘Graphs that teach > graphs that impress’라는 문장으로 방향을 분명히 한다. 즉, 그래프 자체보다 그래프를 통해 사용자가 코드의 의미와 흐름을 배우는 것이 목적이다.

작동 방식: Scan, Map, Teach

• Scan: 멀티 에이전트 파이프라인이 프로젝트를 스캔하고 파일, 함수, 클래스, import, 의존성을 추출한다.
• Map: 추출된 정보를 `.understand-anything/knowledge-graph.json`에 저장하고 대시보드에서 볼 수 있는 그래프로 구성한다.
• Teach: 사용자는 대시보드에서 노드를 클릭하고, 검색하고, 가이드 투어를 따라가며 코드 구조와 비즈니스 로직을 학습한다.

개발팀에 유용한 이유

새 팀원이 20만 줄짜리 코드베이스에 합류했을 때, 가장 어려운 일은 정확한 첫 진입점을 찾는 것이다. Understand Anything은 구조 그래프, 도메인 그래프, 지식 베이스 분석을 제공해 ‘어디서부터 읽어야 하는가’를 더 빠르게 좁혀준다.

특히 비즈니스 로직 뷰는 코드가 실제 업무 흐름과 어떻게 연결되는지를 보여준다. 이는 PM, 기획자, 기술 리더, 신규 개발자 모두에게 의미가 있다. 코드가 단순한 파일 묶음이 아니라 제품의 의사결정과 운영 흐름으로 보이기 때문이다.

지원 플랫폼과 기술 구성

README와 저장소 구조를 보면 Claude Code 플러그인을 중심으로 Codex, Cursor, GitHub Copilot, Copilot CLI, Gemini CLI, OpenCode 등 여러 AI 코딩 환경을 지원한다. 내부 패키지는 TypeScript 기반이며, core 패키지는 tree-sitter 계열 파서와 검색 라이브러리를 활용하고, dashboard 패키지는 React, Vite, d3-force, graphology, ELK, Dagre, React Flow 계열을 사용한다.

좋은 개발 도구는 코드를 대신 읽어주는 데서 끝나지 않는다. 팀이 같은 지도를 보게 만든다.

SpaceTomato Cinema 관점에서 본 의미

SpaceTomato Cinema는 게임형 랜딩 페이지와 블로그 콘텐츠를 함께 운영하는 프로젝트다. 이런 프로젝트도 규모가 커지면 영상 자산, 인터랙션, SEO 페이지, 데이터 업로드 스크립트, 배포 설정이 빠르게 얽힌다. Understand Anything 같은 도구는 이런 복잡도를 시각적으로 정리하고, 다음 작업자가 맥락을 잃지 않게 만드는 데 도움이 된다.

주식회사 럿지, LUDGI Inc.가 만드는 인터랙티브 웹 프로젝트에서도 중요한 것은 결과 화면만이 아니다. 설계 의도, 코드 구조, 콘텐츠 운영 규칙이 함께 이해되어야 지속적으로 확장할 수 있다. 그런 점에서 Understand Anything은 AI 시대의 온보딩 문서와 개발자 경험을 다시 생각하게 만드는 프로젝트다.

원본 저장소: https://github.com/Lum1104/Understand-Anything