새로운 팀에 합류했다. 코드베이스는 200,000줄. 어디서 시작해야 할까?
이것은 모든 개발자가 겪는 악몽이다. 문서는 항상 구식이고, 온보딩은 몇 주가 걸리고, 새 기능을 개발할 때마다 마치 고고학 발굴을 하는 기분이다.
Understand-Anything는 이 문제를 해결한다.
코드베이스를 지도로 변환
Understand-Anything는 Claude Code 플러그인이다. 멀티 에이전트 파이프라인으로 프로젝트 전체를 분석하고, 모든 파일/함수/클래스/의존성을 지식 그래프로 구축한다. 그 다음 인터랙티브 대시보드로 시각 탐색할 수 있다.
핵심 가치
| 문제 | 해결 |
|---|---|
| 20만 줄 코드, 어디서 시작? | 지식 그래프로 시각화 |
| 문서는 항상 구식 | 코드 분석 기반이라 항상 최신 |
| 온보딩에 몇 주 | 구조를 한눈에 파악 |
| 새 기능 = 고고학 발굴 | 의존성 그래프로 영향 범위 파악 |
어떻게 작동하나?
1. 지식 그래프 생성
/understand멀티 에이전트 파이프라인이 실행된다:
- 프로젝트 스캔
- 파일 분석
- 함수/클래스 추출
- 의존성 매핑
- 지식 그래프 생성 →
.understand-anything/knowledge-graph.json
2. 대시보드 탐색
/understand-dashboard인터랙티브 웹 대시보드가 열린다:
- 모든 파일, 함수, 클래스가 노드로 시각화
- 의존성이 엣지로 연결
- 클릭하면 코드와 설명 표시
- 평이한 언어로 설명 (“이 함수는 인증 처리해”)
3. 질문하기
/understand-chat "인증 어떻게 돼?"자연어로 질문하면 그래프 기반으로 답변:
- “인증 처리하는 부분은?”
- “이 함수 어디서 호출돼?”
- “이 모듈이 뭐 하는 거야?“
4. 변경 영향 분석
/understand-diff변경 사항이 시스템에 미치는 영향을 시각화. 커밋 전에 영향 범위 파악.
5. 특정 모듈 심층 분석
/understand-explain src/auth/login.ts특정 파일이나 함수를 깊이 있게 분석.
주요 기능
| 기능 | 설명 |
|---|---|
| 지식 그래프 | 모든 파일, 함수, 클래스, 의존성을 노드로 시각화 |
| 자동 설명 | 각 노드를 LLM이 평이한 언어로 설명 |
| 아키텍처 워크스루 | 의존성 순서대로 아키텍처 안내 |
| 시맨틱 검색 | ”인증 처리하는 부분은?” 질문 가능 |
| 영향 분석 | 변경 사항이 시스템에 미치는 영향 시각화 |
| 적응형 대시보드 | 주니어/PM/파워유저에 맞춰 상세 조절 |
지원 플랫폼
| 플랫폼 | 상태 | 설치 방법 |
|---|---|---|
| Claude Code | ✅ 네이티브 | 플러그인 마켓플레이스 |
| Codex | ✅ 지원 | AI 기반 자동 설치 |
| openCode | ✅ 지원 | AI 기반 자동 설치 |
| openClaw | ✅ 지원 | AI 기반 자동 설치 |
| Cursor | ✅ 지원 | 자동 감지 |
| Antigravity | ✅ 지원 | AI 기반 자동 설치 |
설치
Claude Code
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anythingCursor
클론 후 열면 자동 감지:
git clone https://github.com/Lum1104/Understand-Anything
# Cursor에서 폴더 열기실제 사용 시나리오
시나리오 1: 새 팀 합류
/understand실행- 지식 그래프 생성 (대규모 프로젝트면 몇 분)
/understand-dashboard로 전체 구조 파악/understand-chat "메인 비즈니스 로직 어디 있어?"로 핵심 위치 확인
시나리오 2: 버그 수정
/understand-chat "이 에러 로그에서 어떤 모듈이 문제야?"- 관련 모듈 찾기
/understand-explain src/problematic-module.ts로 심층 분석/understand-diff로 수정 후 영향 범위 확인
시나리오 3: 기능 추가
/understand-chat "결제 로직 어떻게 돼?"- 관련 모듈 파악
/understand-diff로 변경 영향 시각화- 사이드 이펙트 사전 방지
다른 도구와의 차이
| 도구 | 방식 | 장점 | 단점 |
|---|---|---|---|
| Understand-Anything | 지식 그래프 + LLM | 자연어 질문, 시각화 | 대규모 프로젝트는 시간 소요 |
| ctags | 구문 인덱스 | 빠름 | 구문만, 관계 없음 |
| LSP | 타입 정보 | 정확함 | 언어별 설정 필요 |
| grep | 텍스트 검색 | 빠름 | 맥락 없음 |
의미
1. 코드 리딩 → 지도 탐색
더 이상 코드를 한 줄씩 읽을 필요가 없다. 지도를 보듯이 전체 구조를 파악하고, 관심 있는 부분만 확대해서 본다.
2. 온보딩 시간 단축
“인증 어떻게 돼?” 질문하면 즉시 답변. 몇 주 걸리던 온보딩이 며칠로.
3. 변경 영향 사전 파악
커밋 전에 영향 범위를 시각화. 사이드 이펙트 사전 방지.
4. AI 도구에 깊은 컨텍스트 제공
지식 그래프를 다른 AI 도구가 참조. 프로젝트 구조를 이해하는 AI.
마치며: 낯선 코드베이스의 공포 끝
20만 줄 코드베이스에 합류하는 것은 더 이상 공포가 아니다.
/understand한 줄이면 전체 구조가 지도가 된다. 당신은 이제 탐험가가 아니라 내비게이터.
🔗 관련 정보
- GitHub: Lum1104/Understand-Anything
- Demo: lum1104.github.io/Understand-Anything
- 관련 글: Cursor Fast Regex Search