Understand-Anything (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

구조적·도메인 그래프 나란히 표시
코드/문서 전체에 걸친 시맨틱 의미 검색
변경 영향 분석 — X를 건드리면 무엇이 깨지나
적응형 상세도 (시니어 개발자에게는 더 많이, 신입에게는 적게)
Karpathy 스타일 위키 소스에서 force-directed 그래프 합성

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "understand-anything-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "understand-anything-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Lum1104/Understand-Anything",
          "~/.claude/skills/understand-anything"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add understand-anything-skill -- git clone https://github.com/Lum1104/Understand-Anything ~/.claude/skills/understand-anything

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Understand-Anything

20만 줄짜리 코드베이스에 신규 엔지니어 온보딩

👤 신입 사원을 온보딩하는 기술 리더, 또는 프로젝트를 넘겨받는 솔로 개발자 ⏱ ~60 min intermediate

언제 쓸까: 새 저장소, 일주일 안에 생산적이 되어야 할 때.

사전 조건

Skill 설치 — git clone https://github.com/Lum1104/Understand-Anything ~/.claude/skills/understand-anything

흐름

저장소 인덱싱

Use understand-anything. Build the structural graph for ./repo and the domain graph from /docs.✓ 복사됨

→ 그래프 통계 (노드, 엣지, 밀도)
핵심 이음새 찾기

Highlight the 5 most-connected modules — likely architectural seams.✓ 복사됨

→ 근거와 함께 순위 목록
기능 하나 추적

Walk me through 'create checkout' end-to-end across structural + domain graphs.✓ 복사됨

→ 비즈니스 + 기술 홉을 설명하는 노드 경로에 주석

결과: 전체 훑기가 아닌 타겟 읽기로 주가 아닌 며칠 만에 생산적.

함정

그래프가 너무 밀집돼 읽기 어려움 — 디렉토리 또는 기능별 필터; skill은 적응형 상세 수준을 지원

함께 쓰기: filesystem

PR 열기 전에 변경 영향 예측

👤 공유 코드를 수정하려는 개발자 ⏱ ~25 min intermediate

언제 쓸까: '부하를 많이 받는 것 같은' 모듈을 리팩토링하려 할 때.

흐름

변경 사항 정의

Use understand-anything. I'll change the signature of calculateTax(price, region) to add a customer_class. What breaks?✓ 복사됨

→ 업데이트가 필요한 호출자 + 테스트 목록
영향 범위 시각화

Show me the subgraph touched by this change.✓ 복사됨

→ 엣지별 심각도가 있는 강조된 서브그래프
PR 계획

Propose a PR sequence that minimizes review surface — which files first?✓ 복사됨

→ 근거가 있는 파일 순서 목록

결과: 1500줄짜리 괴물이 아닌 사람이 리뷰할 수 있는 크기의 PR.

함정

그래프가 런타임 전용 호출자를 놓침 (리플렉션, 동적 디스패치) — 함수 이름으로 grep해 교차 확인; 런타임 호출자를 별도로 언급

위키를 지식 그래프로 변환

👤 방대한 위키를 가진 연구자/팀 ⏱ ~45 min intermediate

언제 쓸까: 팀에 200페이지짜리 위키가 있는데 아무도 뭘 찾을 수가 없을 때.

흐름

페이지 수집

Use understand-anything. Build a knowledge graph from /wiki/. Extract entities and implicit relationships.✓ 복사됨

→ 엔티티 유형 + 관계 유형이 있는 그래프
막다른 곳 찾기

Which entities are referenced but never defined?✓ 복사됨

→ 페이지가 필요한 스텁 주제 목록
재구성 제안

Based on cluster structure, propose a 5-section TOC.✓ 복사됨

→ 섹션 목록과 할당된 페이지

결과: 실제로 탐색할 수 있는 위키.

함정

암시적 관계가 노이즈로 가득 (모든 페이지가 'API' 언급) — 추출기의 불용어 목록 조정; skill이 일반 노이즈 용어에 대한 설정을 노출

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

understand-anything-skill + filesystem

팀 재사용을 위해 생성된 그래프 영속화

Save the graph to .claude/graphs/ and check in. Refresh on each main merge.✓ 복사됨

understand-anything-skill + git-mcp-idosal

로컬에 클론 없이 원격 공개 저장소의 그래프 구축

Use gitmcp for the repo source; pipe into understand-anything to build the graph in memory.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
build_structural_graph	repo_path, languages?	새 저장소에서 첫 번째 단계
build_domain_graph	docs_path	전체 그림을 위해 구조적 그래프와 함께 사용
semantic_search	intent_query	'X를 처리하는 것은?' — 의미로 찾기
impact_analysis	node_id, change_kind	PR 전 변경 영향 평가
feature_walkthrough	feature_name	온보딩 / 교육 모드

비용 및 제한

운영 비용

API 쿼터: 없음 — 로컬 skill
호출당 토큰: 그래프 구축은 저렴; 쿼리는 서브그래프 크기에 따라 200–1500 token 반환
금액: 무료
팁: main마다 한 번 빌드하고 캐시; 대규모 리팩토링 시 재빌드

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read

자격 증명 저장: 없음

데이터 외부 송신: 없음

그래프에 민감한 코드 구조가 노출될 수 있음 — 공개 공유 시 소스처럼 취급

문제 해결

자주 발생하는 오류와 해결

거대한 저장소에서 빌드가 느림

--include와 --exclude로 범위 지정; 생성/vendor 디렉토리 건너뜀

크로스 언어 호출 누락

skill은 한 번에 단일 언어 저장소에 가장 적합; 다중 언어의 경우 별도 그래프를 빌드하고 수동으로 연결

도메인 그래프가 비어 있음

/docs 경로에 추출기가 인식하는 콘텐츠가 없음; /README + /design-docs로 시도

출력이 너무 밀집돼 읽기 어려움

상세 수준 낮추기; 또는 전체 그래프 뷰 대신 기능 서브그래프로 필터

대안

Understand-Anything 다른 것과 비교

대안	언제 쓰나	단점/장점
graphify-skill	더 가벼운 코드 그래프 skill을 원할 때	도메인 그래프 기능 낮음
Sourcegraph	엔터프라이즈급 코드 검색과 GUI를 원할 때	유료; 설정 오버헤드

Understand-Anything