코드베이스를 지식 그래프로 바꾸는 멀티 에이전트 플러그인 'Understand Anything' 공개

개발자 Lum1104가 코드베이스와 문서, 지식베이스를 대화형 지식 그래프로 바꿔 주는 'Understand Anything'을 깃허브에 공개해 트렌딩 목록에 이름을 올렸다. 이 도구는 Claude Code 플러그인으로, Codex와 Cursor, Copilot, Gemini CLI 등 여러 AI 코딩 도구에서 함께 쓸 수 있다.

프로젝트 출발점은 새 팀에 막 합류한 개발자가 20만 줄짜리 코드베이스를 마주했을 때 어디서부터 봐야 할지 막막한 상황이다. Understand Anything은 멀티 에이전트 파이프라인으로 프로젝트의 모든 파일과 함수, 클래스, 의존성을 분석해 지식 그래프를 만들고, 이를 시각적으로 탐색할 수 있는 대화형 대시보드를 제공한다.

대시보드에서는 모든 파일과 함수, 클래스가 클릭하고 검색하며 탐색할 수 있는 노드로 표현된다. 노드를 선택하면 평이한 설명과 다른 요소와의 관계, 안내 투어가 나타난다. 도메인 뷰로 전환하면 코드가 실제 비즈니스 프로세스, 즉 도메인과 흐름, 단계에 어떻게 대응되는지 가로형 그래프로 볼 수 있다.

기능은 의존성 순서로 정렬된 아키텍처 자동 워크스루, 이름뿐 아니라 의미로도 찾는 검색, 커밋 전에 변경이 시스템 어느 부분에 영향을 미치는지 보여 주는 영향 분석 등으로 구성된다. 코드는 API와 서비스, 데이터, UI, 유틸리티 같은 아키텍처 계층별로 색이 자동 부여되며, 제네릭과 클로저, 데코레이터 등 12가지 프로그래밍 패턴이 등장하는 맥락마다 설명이 붙는다.

대시보드는 사용자가 주니어 개발자인지 프로덕트 매니저인지 숙련 사용자인지에 따라 보여 주는 정보의 상세 수준을 조정한다. 명령어로는 분석을 시작하는 /understand를 비롯해 /understand-dashboard, /understand-chat, /understand-diff, /understand-explain, /understand-onboard, /understand-domain, /understand-knowledge가 있다. 분석 결과 그래프는 .understand-anything/knowledge-graph.json 파일로 저장된다.

--language 파라미터를 쓰면 영어를 기본으로 중국어 간체와 번체, 일본어, 한국어, 러시아어로 결과물을 생성할 수 있다. 이 설정은 지식 그래프의 노드 요약과 설명, 대시보드 UI의 라벨과 버튼, 안내 투어 설명에 모두 적용된다.

/understand-knowledge 명령은 Karpathy 패턴의 LLM 위키를 가리키면 커뮤니티 클러스터링이 적용된 force-directed 지식 그래프를 만든다. 결정론적 파서가 index.md에서 위키링크와 카테고리를 추출하고, 이어 LLM 에이전트들이 암묵적 관계를 찾아내고 엔티티를 추출하며 주장을 끌어낸다.

/understand 명령은 프로젝트 스캐너, 파일 분석기, 아키텍처 분석기, 투어 빌더, 그래프 검토기 등 5개의 전문 에이전트를 조율하며, /understand-domain은 비즈니스 도메인을 추출하는 6번째 에이전트를 더한다. 파일 분석기는 최대 5개가 동시에 돌면서 배치당 20~30개 파일을 처리하고, 증분 업데이트를 지원해 직전 실행 이후 바뀐 파일만 다시 분석한다.

Understand Anything은 Claude Code에서 네이티브로 동작하고, Cursor와 깃허브 코파일럿을 쓰는 VS Code에서는 저장소를 복제하면 자동으로 인식된다. Codex와 OpenCode, Gemini CLI 등 다른 AI 코딩 플랫폼은 한 줄짜리 설치 스크립트를 지원한다. 생성된 그래프는 JSON 파일이라 한 번 커밋해 두면 팀원은 파이프라인을 다시 돌릴 필요 없이 온보딩과 PR 리뷰에 활용할 수 있으며, 10MB가 넘는 큰 그래프는 git-lfs로 관리하도록 안내한다.