Understand-Anything — 코드베이스를 지식 그래프로
Claude Code 플러그인으로, 멀티 에이전트 파이프라인이 프로젝트를 스캔해 파일·함수·클래스·의존성을 인터랙티브 지식 그래프로 시각화합니다. 코드를 "블라인드로 읽지 말고, 큰 그림을 먼저 보자"라는 철학에서 출발한 도구입니다.
"Graphs that teach > graphs that impress."
멋있어 보이는 그래프가 아니라, 가르쳐 주는 그래프가 좋다는 명제입니다. 시각화는 미적 만족이 아니라 인지 부하를 줄이는 데 우선순위를 둡니다.
1. 풀려는 문제 — 200,000 라인 앞에서 어디부터 봐야 하나
새 팀에 합류했을 때 가장 큰 장벽은 코드 자체가 아니라 "어디서 시작해야 할지 모르겠다"는 막막함입니다. Understand-Anything은 그 첫 한 시간을 줄이는 데 집중합니다.
Q. 그냥 README와 폴더 구조를 읽으면 되지 않나요?
README는 의도를 알려주지만 실행 흐름은 보여주지 않습니다. 폴더 구조는 정적이지만 의존성은 동적이에요. Understand-Anything은 정적 분석으로 그래프를 만든 뒤 레이어별 색상, 가이드 투어, 변경 영향 분석으로 "실제로 어떻게 돌아가는가"를 시각적으로 드러냅니다.
2. 멀티 에이전트 파이프라인 — 7개 에이전트가 협업한다
하나의 거대 에이전트가 모든 일을 하는 대신, 역할별로 분리된 전문 에이전트가 순서대로 일을 넘겨 받습니다. 각 단계의 산출물이 다음 단계의 입력이 되는 파이프라인 구조입니다.
project-scanner
프로젝트 파일을 발견하고 사용 언어·프레임워크를 감지
file-analyzer
함수·클래스·import를 추출해 그래프의 노드와 엣지 생성
architecture-analyzer
API · Service · Data · UI · Utility 등 아키텍처 레이어 식별
tour-builder
의존성 순서를 따르는 가이드 학습 투어 자동 생성
graph-reviewer
그래프의 완전성과 참조 무결성 검증
domain-analyzer
비즈니스 도메인·플로우·프로세스 추출 (/understand-domain)
article-analyzer
위키 문서에서 엔티티·주장·암시적 관계 추출 (/understand-knowledge)
파이프라인 구조의 장점은 "단계별 검증"입니다. graph-reviewer가 실제로 별도 단계로 분리되어 있어, file-analyzer의 추출 누락이나 architecture-analyzer의 분류 오류를 사후에 잡아냅니다. 단일 거대 에이전트로는 얻기 어려운 품질 보증입니다.
3. 슬래시 명령 — 8개의 진입점
모든 기능은 Claude Code 슬래시 명령으로 노출됩니다. 각 명령은 파이프라인의 특정 출력을 활용하도록 설계되었습니다.
| 명령 | 역할 |
|---|---|
/understand | 코드베이스 전체 분석 + 지식 그래프 빌드 |
/understand-dashboard | 인터랙티브 웹 대시보드 실행 (그래프 탐색용) |
/understand-chat | 코드베이스에 대해 자연어로 질문 |
/understand-diff | 현재 변경사항이 만들 영향(ripple) 분석 |
/understand-explain | 특정 파일·함수의 심층 설명 |
/understand-onboard | 온보딩 가이드 자동 생성 |
/understand-domain | 비즈니스 도메인 지식 추출 |
/understand-knowledge | Karpathy 패턴 LLM 위키 분석 |
4. 그래프 시각화 — 구조 · 도메인 · 지식의 세 갈래
같은 코드베이스를 세 가지 시점에서 동시에 볼 수 있습니다. 각 시점은 서로 보완적이며, 다른 질문에 답하기 위해 설계되었습니다.
Structural
구조 그래프
파일·함수·클래스를 노드로, 호출·import 관계를 엣지로 표현하는 force-directed 그래프. 코드의 연결 구조를 한눈에.
Domain
도메인 뷰
코드를 비즈니스 프로세스·워크플로우에 매핑. 기획자나 PM과의 대화에서 "어떤 코드가 어떤 기능에 해당하나"를 즉시 보여줍니다.
Knowledge
지식 그래프
Karpathy 패턴의 LLM 위키 문서를 분석해 엔티티·주장·암시적 관계를 force-directed 그래프로 시각화.
5. 핵심 기능
그래프를 만드는 데서 끝나지 않고, 그 위에서 검색·질문·변경 영향 분석까지 수행하도록 설계되어 있습니다.
구조 그래프 탐색 — 파일·함수·클래스의 force-directed 그래프, 패닝/줌 지원
가이드 투어 — 의존성 순서로 정렬된 아키텍처 워크스루 자동 생성
퍼지 + 시맨틱 검색 — 이름으로도, 의미로도 코드를 찾을 수 있음
Diff 영향 분석 — 현재 변경이 어디까지 영향을 미치는지 그래프 위에 하이라이트
레이어 색상 코딩 — API · Service · Data · UI · Utility를 자동으로 색상 분리
페르소나 적응 UI — 주니어 개발자, PM, 파워 유저별로 정보량 조절
12개 프로그래밍 패턴 설명 — 코드 맥락에서 패턴을 자동 식별하고 해설
증분 업데이트 — 변경된 부분만 다시 분석해 빠르게 그래프 갱신
JSON 그래프 공유 — 분석 결과를 버전 관리에 커밋해 팀과 공유
6. 설치와 시작
설치는 한 줄, 사용은 세 단계입니다. Claude Code뿐 아니라 Codex, Cursor, Copilot, Gemini CLI 등 다양한 에이전트 환경에서 동작합니다.
1) 설치 (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
2) 분석 실행
Claude Code에서 /understand를 입력하면 멀티 에이전트 파이프라인이 프로젝트를 스캔하고 지식 그래프를 빌드합니다.
3) 대시보드 탐색
/understand-dashboard로 인터랙티브 웹 대시보드를 열어 그래프를 탐색하고, 투어를 따라가며, 코드에 자연어로 질문합니다.
Q. 분석 결과를 팀과 공유할 수 있나요?
네, 분석 결과는 JSON 파일로 저장되며 버전 관리에 그대로 커밋할 수 있습니다. 팀원이 같은 그래프를 보고 같은 투어를 따라갈 수 있어, 온보딩 문서를 별도로 작성할 필요가 줄어듭니다. 증분 업데이트도 지원해 코드 변경에 따라 그래프만 빠르게 갱신됩니다.
7. 정리 — 코드는 읽지 말고 그리자
Understand-Anything이 보여주는 통찰은 분명합니다. 거대한 코드베이스를 다루는 핵심은 더 빠르게 읽는 능력이 아니라, 더 좋은 시각적 모델을 갖는 능력입니다.
그래프는 가르쳐야 한다 — 멋있는 시각화보다 인지 부하를 줄이는 그래프가 우선
에이전트는 역할별로 분리한다 — 7개 에이전트가 파이프라인으로 협업하며 graph-reviewer가 품질을 보증
구조 · 도메인 · 지식의 세 시점 — 같은 코드를 다른 질문으로 보면 답이 달라진다
온보딩은 그래프 + 투어 + Q&A로 — README보다 실행 흐름과 의존성이 먼저 보여야 한다
변경의 영향은 그래프 위에 그려야 한다 — Diff 영향 분석으로 리뷰의 사각지대를 줄인다