Egonex-AI/Understand-Anything

<h1 align="center">Understand Anything</h1>

<p align="center"> <strong>모든 코드베이스, 지식 베이스, 또는 문서를 대화형 지식 그래프로 변환하여 탐색, 검색, 질문할 수 있습니다.</strong> <br /> <em>Claude Code, Codex, Cursor, Copilot, Gemini CLI 등과 함께 작동합니다.</em> </p>

<p align="center"> <strong>Understand Anything. <a href="https://egonex.ai">Understand Anyone.</a></strong> <br /> <em>AI는 사람을 도와야 하지, 대체해서는 안 됩니다.</em> </p>

<p align="center"> <a href="README.md">English</a> | <a href="READMEs/README.zh-CN.md">简体中文</a> | <a href="READMEs/README.zh-TW.md">繁體中文</a> | <a href="READMEs/README.ja-JP.md">日本語</a> | <a href="READMEs/README.ko-KR.md">한국어</a> | <a href="READMEs/README.es-ES.md">Español</a> | <a href="READMEs/README.tr-TR.md">Türkçe</a> | <a href="READMEs/README.ru-RU.md">Русский</a> </p>

새 팀에 합류했습니다. 코드베이스는 200,000줄입니다. 어디서부터 시작해야 할까요?

Understand Anything은 Claude Code Plugin으로, 멀티 에이전트 파이프라인으로 프로젝트를 분석하고 모든 파일, 함수, 클래스, 의존성의 지식 그래프를 구축한 후, 이를 시각적으로 탐색할 수 있는 대화형 대시보드를 제공합니다. 더 이상 코드를 맹목적으로 읽지 마세요. 큰 그림을 보기 시작하세요.

목표는 코드베이스가 얼마나 복잡한지에 감탄하게 만드는 그래프가 아니라, 모든 조각이 어떻게 맞물리는지 조용히 가르쳐주는 그래프입니다.

✨ 기능

[!NOTE]

읽기를 건너뛰고 싶으신가요? 홈페이지에서 라이브 데모를 사용해보세요 — 브라우저에서 바로 팬, 확대/축소, 검색, 탐색할 수 있는 완전한 대화형 대시보드입니다.

구조 그래프 탐색

코드베이스를 대화형 지식 그래프로 탐색하세요 — 모든 파일, 함수, 클래스는 클릭, 검색, 탐색할 수 있는 노드입니다. 노드를 선택하면 일반 영어 요약, 관계, 가이드 투어를 볼 수 있습니다.

비즈니스 로직 이해

도메인 보기로 전환하여 코드가 실제 비즈니스 프로세스에 어떻게 매핑되는지 확인하세요 — 도메인, 흐름, 단계가 수평 그래프로 표시됩니다.

지식 베이스 분석

/understand-knowledge를 Karpathy 패턴 LLM 위키에 지정하면 커뮤니티 클러스터링이 적용된 힘 기반 지식 그래프를 얻을 수 있습니다. 결정론적 파서가 index.md에서 위키링크와 카테고리를 추출한 후, LLM 에이전트가 암시적 관계를 발견하고, 엔터티를 추출하며, 주장을 표면화하여 위키를 상호 연결된 아이디어의 탐색 가능한 그래프로 변환합니다.

<table> <tr> <td width="50%" valign="top"> <h3>🧭 가이드 투어</h3> <p>의존성 순서로 정렬된 아키텍처의 자동 생성된 둘러보기입니다. 올바른 순서로 코드베이스를 학습하세요.</p> </td> <td width="50%" valign="top"> <h3>🔍 퍼지 및 의미 검색</h3> <p>이름이나 의미로 무엇이든 찾으세요. "인증을 처리하는 부분은?"을 검색하면 그래프 전체에서 관련 결과를 얻을 수 있습니다.</p> </td> </tr> <tr> <td width="50%" valign="top"> <h3>📊 Diff 영향 분석</h3> <p>커밋하기 전에 변경 사항이 시스템의 어떤 부분에 영향을 미치는지 확인하세요. 코드베이스 전반의 파급 효과를 이해하세요.</p> </td> <td width="50%" valign="top"> <h3>🎭 페르소나 적응형 UI</h3> <p>대시보드는 사용자(주니어 개발자, PM, 파워 유저)에 따라 세부 수준을 조정합니다.</p> </td> </tr> <tr> <td width="50%" valign="top"> <h3>🏗️ 계층 시각화</h3> <p>API, Service, Data, UI, Utility 등 아키텍처 계층별 자동 그룹화와 색상 코드 범례를 제공합니다.</p> </td> <td width="50%" valign="top"> <h3>📚 언어 개념</h3> <p>12가지 프로그래밍 패턴(제네릭, 클로저, 데코레이터 등)이 나타나는 컨텍스트에서 설명됩니다.</p> </td> </tr> </table>

🚀 빠른 시작

1. 플러그인 설치

/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything

로컬 모델을 사용하시나요? 프라이버시 또는 엔터프라이즈 설정을 위해 Ollama와 같은 로컬 모델 제공자를 가리키도록 플랫폼을 설정하세요 — 모델 제공자를 변경하려면 해당 통합 가이드를 따르세요.

2. 코드베이스 분석

/understand

멀티 에이전트 파이프라인이 프로젝트를 스캔하고 모든 파일, 함수, 클래스, 의존성을 추출한 후 .understand-anything/knowledge-graph.json에 저장된 지식 그래프를 구축합니다.

토큰 사용량 주의: 초기 /understand는 전체 코드베이스를 분석하며 대규모 프로젝트에서 상당한 토큰을 소모할 수 있습니다. 토큰 플랜/구독에서 실행하거나 초기화에 로컬 모델(위 참조)을 사용하는 것이 좋습니다. 이후 실행은 기본적으로 증분 방식이므로 변경된 파일만 다시 분석되어 훨씬 적은 토큰을 사용합니다.

지역화된 출력: --language를 사용하여 원하는 언어로 콘텐츠를 생성하세요:

# 중국어 콘텐츠 생성 (지식 그래프 노드 설명 및 대시보드 UI)
/understand --language zh

# 지원 언어: en (기본값), zh, zh-TW, ja, ko, ru

프로젝트에서 첫 번째 실행 시 --language를 전달하지 않고 저장된 언어가 없으면 /understand는 대화 중인 언어를 감지합니다. 영어가 아닌 경우 생성 전에 확인(또는 재정의)을 요청합니다. 영어 대화는 영향을 받지 않습니다. 선택 사항은 .understand-anything/config.json에 저장되어 이후 모든 실행에서 재사용됩니다.

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

--language 매개변수는 다음에 영향을 미칩니다:

3. 대시보드 탐색

/understand-dashboard

코드베이스가 그래프로 시각화된 대화형 웹 대시보드가 열립니다 — 아키텍처 계층별로 색상 코드가 지정되고 검색 가능하며 클릭할 수 있습니다. 노드를 선택하면 코드, 관계, 일반 영어 설명을 볼 수 있습니다.

4. 계속 학습

# 코드베이스에 대해 무엇이든 물어보기
/understand-chat 결제 흐름은 어떻게 작동하나요?

# 현재 변경 사항의 영향 분석
/understand-diff

# 특정 파일 또는 함수 심층 분석
/understand-explain src/auth/login.ts

# 새 팀원을 위한 온보딩 가이드 생성
/understand-onboard

# 비즈니스 도메인 지식 추출 (도메인, 흐름, 단계)
/understand-domain

# Karpathy 패턴 LLM 위키 지식 베이스 분석
/understand-knowledge ~/path/to/wiki

# 언제든지 재실행 — 기본적으로 증분 방식 (변경된 파일만 다시 분석)
/understand

# post-commit 훅을 통해 모든 커밋 시 자동 업데이트
/understand --auto-update

# 하위 디렉토리로 범위 지정 (대규모 모노레포용)
/understand src/frontend

🌐 멀티 플랫폼 설치

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

Claude Code (네이티브)

/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything

원라인 설치 (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI / Trae / Nanobot / Kiro)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash
# 또는 프롬프트를 건너뛰려면 플랫폼을 전달:
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s codex

Windows (PowerShell):

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

설치 프로그램은 저장소를 ~/.understand-anything/repo에 클론하고 선택한 플랫폼에 맞는 올바른 심볼릭 링크를 생성합니다. 이후 CLI/IDE를 다시 시작하세요.

• 지원되는 <platform> 값: gemini, codex, opencode, pi, openclaw, antigravity, vibe, vscode, hermes, cline, kimi, trae, nanobot, kiro
• 업데이트: ./install.sh --update
• 제거: ./install.sh --uninstall <platform>

Cursor

Cursor는 이 저장소가 클론되면 .cursor-plugin/plugin.json을 통해 플러그인을 자동으로 발견합니다. 수동 설치가 필요 없습니다 — 저장소를 클론하고 Cursor에서 열기만 하면 됩니다.

자동 발견이 작동하지 않으면 수동으로 설치하세요: Cursor 설정 → 플러그인을 열고 검색 필드에 https://github.com/Egonex-AI/Understand-Anything를 붙여넣고 추가하세요.

VS Code + GitHub Copilot

VS Code with GitHub Copilot (v1.108+)은 이 저장소가 클론되면 .copilot-plugin/plugin.json을 통해 플러그인을 자동으로 발견합니다. 수동 설치가 필요 없습니다 — 저장소를 클론하고 VS Code에서 열기만 하면 됩니다.

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

Copilot CLI

copilot plugin install Egonex-AI/Understand-Anything:understand-anything-plugin

Kiro CLI / IDE

curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s kiro

• Kiro CLI: kiro-cli chat --agent understand "이 프로젝트 분석"
• Kiro IDE: 스킬이 ~/.kiro/skills/에 심볼릭 링크되고 understand 에이전트가 ~/.kiro/agents/understand.json에 기록되므로 IDE 재시작 후 둘 다 사용할 수 있습니다.

설치 후:

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

플랫폼 호환성

🧠 사용 방법

기본 명령어

옵션

🏗️ 아키텍처

Understand Anything은 다음으로 구성됩니다:

1. 스캐너 — 파일 시스템을 탐색하고 코드 구조 추출
2. 파서 — 파일을 구문 분석하여 함수, 클래스, 의존성 식별
3. 그래프 빌더 — 추출된 정보에서 지식 그래프 구축
4. LLM 에이전트 — 그래프 노드에 대한 설명, 관계, 통찰력 생성
5. 대시보드 — 그래프 탐색을 위한 대화형 웹 UI

파이프라인은 완전히 오프라인에서 실행 가능하며, LLM 에이전트 단계만 외부 API 호출이 필요합니다.

🤝 기여

기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

📄 라이선스

MIT