AI Sparkup

최신 AI 쉽게 깊게 따라잡기⚡

Understand-Anything – 코드베이스·지식 베이스를 탐색 가능한 인터랙티브 지식 그래프로 변환하는 Claude Code 플러그인

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
CodexFetch 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 CLIgemini skills install 명령어 사용

아키텍처

  1. 분석 단계: 멀티 에이전트 파이프라인이 프로젝트 스캔 → 파일·함수·클래스·의존성 추출 → .understand-anything/knowledge-graph.json 저장
  2. 시각화 단계: 인터랙티브 웹 대시보드가 그래프를 렌더링 — 아키텍처 레이어별 색상 코딩, 검색, 클릭 탐색 지원

누구에게 유용한가

  • 신규 팀원: 대형 코드베이스 빠르게 파악
  • 아키텍처 리뷰어: 레이어·의존성·비즈니스 로직 시각화
  • AI 에이전트 빌더: 지식 베이스를 그래프로 변환해 에이전트 컨텍스트로 활용

참고 자료



AI Sparkup 구독하기

최신 게시물 요약과 더 심층적인 정보를 이메일로 받아 보세요! (무료)