Understand-Anything: 코드베이스, 지식 베이스, 문서를 탐색 가능한 인터랙티브 지식 그래프로 변환

모든 코드베이스, 지식 베이스(knowledge base), 또는 문서를 탐색, 검색 및 질문이 가능한 인터랙티브 지식 그래프(knowledge graph)로 변환하세요.

Claude Code, Codex, Cursor, Copilot, Gemini CLI 등과 함께 작동합니다.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский

💬 Discord 커뮤니티에 참여하세요 →

질문을 하고, 직접 만든 것을 공유하며, 커뮤니티로부터 도움을 받으세요.

당신은 막 새로운 팀에 합류했습니다. 코드베이스는 20만 줄에 달합니다. 어디서부터 시작해야 할까요?

Understand Anything는 멀티 에이전트 파이프라인(multi-agent pipeline)을 통해 프로젝트를 분석하고, 모든 파일, 함수(function), 클래스(class), 의존성(dependency)의 지식 그래프를 구축한 뒤, 이를 시각적으로 탐색할 수 있는 인터랙티브 대시보드를 제공하는 Claude Code 플러그인(plugin)입니다. 코드만 무작정 읽는 것을 멈추세요. 전체적인 그림을 보기 시작하세요.

목표는 코드베이스가 얼마나 복잡한지를 보여주며 감탄을 자아내는 그래프를 만드는 것이 아닙니다. 모든 조각이 어떻게 서로 맞물려 있는지 조용히 가르쳐 주는 그래프를 만드는 것입니다.

참고

읽는 과정을 건너뛰고 싶으신가요? 저희 홈페이지의 라이브 데모를 시도해 보세요. 브라우저에서 바로 팬(pan), 줌(zoom), 검색 및 탐색이 가능한 완전한 인터랙티브 대시보드를 제공합니다.

코드베이스를 인터랙티브 지식 그래프로 탐색하세요. 모든 파일, 함수, 클래스는 클릭, 검색 및 탐색이 가능한 노드(node)입니다. 노드를 선택하면 쉬운 영어로 된 요약, 관계 및 가이드 투어를 볼 수 있습니다.

도메인 뷰(domain view)로 전환하여 코드가 실제 비즈니스 프로세스에 어떻게 매핑되는지 확인하세요. 도메인, 흐름(flows), 단계(steps)가 수평 그래프로 나열됩니다.

Karpathy-pattern LLM 위키(wiki)에 /understand-knowledge 명령어를 입력하면, 커뮤니티 클러스터링(community clustering)이 적용된 포스 디렉티드(force-directed) 지식 그래프를 얻을 수 있습니다. 결정론적 파서(deterministic parser)가 index.md에서 위키링크(wikilinks)와 카테고리를 추출하면, LLM 에이전트(agent)가 암시적 관계를 발견하고 엔티티(entity)를 추출하며 주장(claims)을 표면화하여, 당신의 위키를 서로 연결된 아이디어의 탐색 가능한 그래프로 변환합니다.

| 의존성 순서에 따라 자동 생성된 아키텍처 워크스루 (walkthroughs). 올바른 순서로 코드베이스 (codebase)를 학습하세요. |
이름이나 의미로 무엇이든 찾으세요. "인증 (auth)을 처리하는 부분은 어디인가요?"라고 검색하면 그래프 전체에서 관련 결과를 얻을 수 있습니다. |
| 커밋하기 전에 당신의 변경 사항이 시스템의 어느 부분에 영향을 미치는지 확인하세요. 코드베이스 전반에 걸친 파급 효과 (ripple effects)를 이해할 수 있습니다. |
대시보드는 사용자가 주니어 개발자, PM, 또는 파워 유저인지에 따라 상세 수준을 조정합니다. |
| API, Service, Data, UI, Utility 등 아키텍처 계층 (architectural layer)별 자동 그룹화 및 색상 코드가 지정된 범례 (legend) 제공. |
12가지 프로그래밍 패턴 (제네릭 (generics), 클로저 (closures), 데코레이터 (decorators) 등)이 나타나는 곳마다 문맥에 맞춰 설명됩니다. |

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

/understand

멀티 에이전트 파이프라인 (multi-agent pipeline)이 프로젝트를 스캔하여 모든 파일, 함수, 클래스 및 의존성을 추출한 다음, .understand-anything/knowledge-graph.json에 저장되는 지식 그래프 (knowledge graph)를 구축합니다.

현지화된 출력 (Localized output): 선호하는 언어로 콘텐츠를 생성하려면 --language를 사용하세요:

# 중국어 콘텐츠 생성 (지식 그래프 노드 설명 및 대시보드 UI)
/understand --language zh
# 지원되는 언어: en (기본값), zh, zh-TW, ja, ko, ru

--language 파라미터는 다음 항목에 영향을 미칩니다:

• 지식 그래프 내 노드 요약 및 설명
• 대시보드 UI 레이블, 버튼 및 툴팁 (tooltips)
• 가이드 투어 (guided tour) 설명

/understand-dashboard

코드베이스가 그래프로 시각화된 인터랙티브 웹 대시보드가 열립니다. 아키텍처 계층별로 색상이 지정되어 있으며, 검색 및 클릭이 가능합니다. 노드를 선택하면 해당 노드의 코드, 관계 및 쉬운 영어(plain-English) 설명을 볼 수 있습니다.

# 코드베이스에 대해 무엇이든 물어보세요
/understand-chat 결제 흐름 (payment flow)은 어떻게 작동하나요?
# 현재 변경 사항의 영향을 분석하세요
...

Understand-Anything은 여러 AI 코딩 플랫폼에서 작동합니다.

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

일회성 설치 (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
# 또는 플랫폼을 전달하여 프롬프트 건너뛰기:
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

설치 스크립트는 저장소(repo)를 ~/.understand-anything/repo에 복제하고, 선택한 플랫폼에 맞는 적절한 심볼릭 링크(symlinks)를 생성합니다. 이후 CLI/IDE를 다시 시작하세요.

• 지원되는 <platform> 값:
  gemini, codex, opencode, pi, openclaw, antigravity, vibe, vscode, hermes, cline, kimi

• 나중에 업데이트:
  ./install.sh --update

• 제거(Uninstall):
  ./install.sh --uninstall <platform>

Cursor는 이 저장소가 복제될 때 .cursor-plugin/plugin.json을 통해 플러그인을 자동으로 감지합니다. 수동 설치가 필요 없으며, 단순히 클론하여 Cursor에서 열기만 하면 됩니다.

VS Code와 GitHub Copilot (v1.108+)은 이 저장소가 복제될 때 .copilot-plugin/plugin.json을 통해 플러그인을 자동으로 감지합니다. 수동 설치가 필요 없으며, 단순히 클론하여 VS Code에서 열기만 하면 됩니다.

개인용 스킬(모든 프로젝트에서 사용 가능)의 경우, 위의 install.sh를 실행하고 vscode 플랫폼을 사용하세요.

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

Platform	Status	Install Method
Claude Code	✅ Native	Plugin marketplace
...
그래프는 단순히 JSON 파일입니다. 한 번 커밋하면 팀원들은 파이프라인을 건너뛸 수 있습니다. 온보딩, PR 검토, 문서-코드(docs-as-code)에 유용합니다.

예시: GoogleCloudPlatform/microservices-demo (fork) — 그래프가 커밋된 Go / Java / Python / Node 참조 자료.

커밋할 내용: .understand-anything/ 내부의 모든 파일 제외 intermediate/ 및 diff-overlay.json (이들은 로컬 임시 파일입니다).

.understand-anything/intermediate/
.understand-anything/diff-overlay.json

최신 상태 유지: /understand --auto-update를 활성화하세요.

— 커밋 후 훅 (post-commit hook)이 그래프를 점진적으로 패치하여 각 커밋이 일치하는 그래프와 함께 반영되도록 합니다. 또는 릴리스 전에 수동으로 /understand를 다시 실행하세요.

대규모 그래프 (10 MB 이상): git-lfs로 추적하세요.

git lfs install
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/

/understand 명령은 5개의 특화된 에이전트 (agents)를 조율하며, /understand-domain은 6번째 에이전트를 추가합니다:

에이전트 (Agent)	역할 (Role)
project-scanner	파일 발견, 언어 및 프레임워크 감지
file-analyzer	함수, 클래스, 임포트 (imports) 추출; 그래프 노드 및 엣지 (edges) 생성
architecture-analyzer	아키텍처 계층 (architectural layers) 식별
tour-builder	가이드형 학습 투어 생성
graph-reviewer	그래프의 완전성 및 참조 무결성 (referential integrity) 검증 (기본적으로 인라인으로 실행됨; 전체 LLM 리뷰를 위해 --review 사용)
domain-analyzer	비즈니스 도메인, 흐름 및 프로세스 단계 추출 (/understand-domain에서 사용)
article-analyzer	위키 문서에서 엔티티 (entities), 주장 (claims) 및 암시적 관계 추출 (/understand-knowledge에서 사용)

파일 분석기 (File analyzers)는 병렬로 실행됩니다 (최대 5개 동시 실행, 배치당 20-30개 파일). 점진적 업데이트 (incremental updates)를 지원하여 마지막 실행 이후 변경된 파일만 다시 분석합니다.

기여를 환영합니다! 시작하는 방법은 다음과 같습니다:

• 저장소 포크 (Fork)
• 기능 브랜치 생성 (git checkout -b feature/my-feature)
• 테스트 실행 (pnpm --filter @understand-anything/core test)
• 변경 사항을 커밋하고 풀 리퀘스트 (pull request) 생성

주요 변경 사항의 경우, 접근 방식을 논의할 수 있도록 먼저 이슈 (issue)를 생성해 주세요.

코드를 맹목적으로 읽는 것을 멈추세요. 모든 것을 이해하기 시작하세요.

사용하고 기여해 주신 모든 분들께 감사드립니다 — 이것이 사람들의 시간을 아껴준다는 사실을 아는 것이 이 프로젝트를 만들 가치가 있게 했습니다.

MIT License © Lum1104