Understand Anything

코드·문서·Figma 구조를 탐색 가능한 지식 그래프로 바꾸는 크로스 에이전트 분석 스킬

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

코드베이스의 파일·함수·클래스·호출·상속 관계를 Tree-sitter로 추출하고 여러 분석 에이전트가 요약, 아키텍처 계층, 업무 도메인과 가이드 투어를 보강해 대화형 지식 그래프를 만드는 도구입니다. Claude Code에서는 네이티브 플러그인으로, Codex·OpenCode·OpenClaw·Gemini CLI·Kimi CLI 등에서는 공통 설치 스크립트로 쓸 수 있습니다. 생성 결과는 `.ua/knowledge-graph.json`을 중심으로 로컬에 남고, 분석 뒤 뷰어만 열 때는 Node.js 18 이상으로 읽기 전용 대시보드를 실행해 LLM 호출 없이 탐색할 수 있습니다. v2.9.0은 코드 외에 Figma 페이지·화면·컴포넌트·토큰 관계까지 분석하는 `/understand-figma`를 추가했습니다.

판단

이럴 때 씁니다

  • 처음 맡은 대형 저장소의 구조와 업무 흐름을 빠르게 파악해야 할 때
  • 코드·지식 위키·Figma 디자인을 탐색 가능한 공통 그래프로 공유하고 싶을 때
  • 여러 코딩 에이전트에서 같은 온보딩 스킬과 그래프 산출물을 재사용할 때

이럴 땐 쓰지 마세요

  • 소스가 외부 모델 공급자로 전송되는 것을 허용할 수 없고 로컬 모델 경로도 준비되지 않은 경우
  • 변경 영향만 빠르게 로컬 질의하면 충분해 멀티에이전트 의미 분석 비용이 불필요한 경우
  • 그래프 산출물의 민감 정보·보관 정책을 정하지 않은 공개 저장소

차별점

  • 결정론적 Tree-sitter 구조 분석과 LLM 의미 분석을 나눠 같은 입력의 기본 그래프를 재현할 수 있습니다.
  • 구조 그래프뿐 아니라 업무 도메인 흐름, 지식 위키, Figma 디자인 그래프를 각각 전용 명령으로 만듭니다.
  • 생성된 `.ua` 그래프를 저장소에 커밋하면 팀원이 LLM이나 API 키 없이 로컬 뷰어로 탐색할 수 있습니다.
  • Claude Code 외 Codex·OpenCode·OpenClaw·Gemini CLI·Copilot·Cursor 등 다수 에이전트 설치 표면을 유지합니다.

워크플로

  1. 01설치 스크립트나 Claude 플러그인 마켓플레이스로 대상 에이전트에 스킬을 설치합니다.
  2. 02저장소 루트에서 `/understand` 또는 Codex의 `$understand`를 실행하고 분석 범위·모델·제외 대상을 확인합니다.
  3. 03정적 구조 추출 뒤 파일 분석·아키텍처·도메인·투어 에이전트 결과를 병합하고 검증합니다.
  4. 04`.ua/knowledge-graph.json`과 대시보드를 검토하고 공유할 파일과 로컬 전용 중간물을 나눕니다.
  5. 05후속 커밋에는 증분 분석이나 post-commit 자동 갱신을 사용해 그래프를 최신 상태로 유지합니다.

주요 명령

명령설명
/understandClaude Code에서 현재 프로젝트를 분석하거나 변경 파일만 증분 갱신합니다.
$understandCodex에서 설치된 Understand Anything 스킬을 호출합니다.
/understand-domain코드를 업무 도메인·흐름·단계 관점으로 분석합니다.
/understand-figmaFigma 파일의 페이지·화면·컴포넌트와 디자인 토큰 관계를 그래프로 만듭니다.
npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz .생성된 `.ua` 데이터를 LLM 호출 없이 읽기 전용 대시보드로 엽니다.

함정

설치 전에 확인하세요

  • 최초 전체 분석은 여러 파일 분석 에이전트를 실행해 토큰과 시간이 많이 들 수 있습니다. 이후에는 증분 실행을 사용하고 분석 범위를 먼저 확인하세요.
  • LLM 분석 단계에서는 소스 내용이 선택한 모델 공급자에게 전달될 수 있습니다. 민감 저장소는 승인된 공급자·로컬 모델 경로와 제외 규칙을 먼저 정해야 합니다.
  • `.ua/knowledge-graph.json`에는 코드 구조와 업무 지식이 들어갑니다. 공개 저장소에 커밋하기 전 민감 정보와 크기를 검토하고 10MB가 넘으면 Git LFS를 고려하세요.
  • 공식 설치 스크립트는 사용자 홈 아래 저장소를 복제하고 심볼릭 링크를 만듭니다. curl 파이프 실행 전 현재 스크립트와 대상 경로를 검토하세요.
  • Figma 분석에는 `FIGMA_TOKEN`이 필요합니다. 토큰은 요청 헤더로만 보내도록 설계됐지만 최소 권한과 만료 정책을 적용해야 합니다.

비교

CodeGraph가 20개 언어의 코드 변경을 로컬 그래프와 MCP 질의로 추적하는 데 강하다면, Understand Anything은 멀티에이전트가 구조·아키텍처·업무 도메인·학습 투어를 만들고 브라우저 대시보드로 온보딩하는 흐름이 중심입니다. Graphify보다 코드베이스 온보딩 명령과 에이전트 플러그인 배포가 구체적입니다.

최근 변경

v2.9.0에서 Figma 디자인 그래프, `.ua/` 데이터 디렉터리, Dart·Scala·Swift·Kotlin 지원, Kiro 설치 경로와 스킬 주입 ReDoS·재귀 서브에이전트 방어를 추가했습니다.

공식 변경 내역