Understand-Anything은 멀티 에이전트 파이프라인으로 코드베이스를 분석해 파일·함수·클래스·의존성의 지식 그래프를 구축하고, 인터랙티브 대시보드로 탐색할 수 있게 하는 오픈소스 Claude Code 플러그인이다. “그래프가 인상을 주는 것보다 가르치는 것”을 목표로, 신규 팀원 온보딩·아키텍처 이해·코드 영향 분석에 활용한다.
신규 팀 합류. 코드베이스 20만 라인. 어디서 시작해야 할까?
주요 기능
구조 그래프 탐색
파일·함수·클래스가 노드로 표현된 인터랙티브 지식 그래프. 노드를 클릭하면 평문(Plain-English) 요약, 관계, 가이드 투어를 볼 수 있다.
비즈니스 로직 이해
도메인 뷰로 전환해 코드가 실제 비즈니스 프로세스에 어떻게 매핑되는지 확인. 도메인·플로우·단계가 수평 그래프로 표현된다.
지식 베이스 분석
Karpathy 패턴 LLM 위키를 /understand-knowledge로 분석해 포스-다이렉티드 지식 그래프 생성. wikilink와 카테고리를 파싱하고 LLM 에이전트가 암묵적 관계를 발굴한다.
추가 기능
| 기능 | 설명 |
|---|---|
| 가이드 투어 | 의존성 순서로 정렬된 아키텍처 자동 워크스루 |
| 퍼지·시맨틱 검색 | “인증을 처리하는 부분은?” 같은 의미 기반 검색 |
| Diff 영향 분석 | 변경 전 영향 범위 시각화 |
| 페르소나 적응 UI | 주니어 개발자·PM·파워 유저별 다른 수준의 상세 정보 |
| 레이어 시각화 | API·Service·Data·UI·Utility 계층별 색상 코딩 |
| 언어 개념 설명 | 제네릭·클로저·데코레이터 등 12개 패턴을 컨텍스트 내 설명 |
빠른 시작
Claude Code (기본)
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything# 코드베이스 분석 (knowledge-graph.json 생성)
/understand
# 인터랙티브 대시보드 열기
/understand-dashboard주요 명령어
# 코드베이스에 대해 자유롭게 질문
/understand-chat 결제 플로우는 어떻게 동작하나요?
# 현재 변경사항의 영향 분석
/understand-diff
# 특정 파일 또는 함수 상세 설명
/understand-explain src/auth/login.ts
# 신규 팀원을 위한 온보딩 가이드 생성
/understand-onboard
# 비즈니스 도메인 지식 추출
/understand-domain
# LLM 위키 지식 베이스 분석
/understand-knowledge ~/path/to/wiki멀티 플랫폼 지원
| 플랫폼 | 설치 방법 |
|---|---|
| Claude Code | /plugin marketplace add Lum1104/Understand-Anything |
| Codex | Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md |
| OpenCode | .opencode/INSTALL.md 참조 |
| Cursor | .cursor/rules/ 에 스킬 파일 복사 |
| VS Code + Copilot | .vscode 설정 파일 참조 |
| Gemini CLI | gemini skills install 명령어 사용 |
아키텍처
- 분석 단계: 멀티 에이전트 파이프라인이 프로젝트 스캔 → 파일·함수·클래스·의존성 추출 →
.understand-anything/knowledge-graph.json저장 - 시각화 단계: 인터랙티브 웹 대시보드가 그래프를 렌더링 — 아키텍처 레이어별 색상 코딩, 검색, 클릭 탐색 지원
누구에게 유용한가
- 신규 팀원: 대형 코드베이스 빠르게 파악
- 아키텍처 리뷰어: 레이어·의존성·비즈니스 로직 시각화
- AI 에이전트 빌더: 지식 베이스를 그래프로 변환해 에이전트 컨텍스트로 활용
참고 자료
- Lum1104/Understand-Anything — GitHub 공식 저장소
- 라이브 데모 — understand-anything.com