Understand — 코드베이스 지식 그래프 생성기
프로젝트 전체를 스캔해 아키텍처·컴포넌트·의존관계를 담은 인터랙티브 지식 그래프(knowledge-graph.json)를 만들어 줍니다.
개발·코딩중급★ 78,314⑂ 6,578AI 점수 8/10마지막 업데이트: 2026. 7. 30.
무엇을 해주나
/understand 명령 하나로 현재(또는 지정한) 저장소를 훑어 .ua/knowledge-graph.json을 생성합니다. 내부적으로 7단계 파이프라인을 돕니다.
- Phase 0~1: 프로젝트 루트·git 워크트리 판별,
.understandignore생성, 파일/언어/프레임워크 스캔 - Phase 1.5~2: 의미 단위 배치 계산 후 최대 5개 서브에이전트 병렬 분석 → 노드·엣지 생성, ID 정규화 및 중복 제거
- Phase 3~4: 조립된 그래프 검수, 디렉터리 구조와 프레임워크 지식을 활용한 아키텍처 레이어 도출
- 커밋 해시를 비교해 변경된 파일만 재분석하는 증분 업데이트를 지원하고,
--language ko로 요약·태그를 한국어로 생성할 수 있습니다.
이런 분께 추천
- 처음 합류한 프로젝트의 구조를 빠르게 파악해야 하는 개발자
- 레거시 코드의 모듈 간 의존관계를 시각적으로 정리하고 싶은 팀 리드
- 온보딩 문서나 아키텍처 다이어그램의 초안을 자동으로 얻고 싶은 분
활용 예시
/understand --language ko— 처음 받은 저장소를 분석해 한국어 요약이 담긴 지식 그래프를 만듭니다./understand ../legacy-api --exclude "tests/*,docs/*"— 다른 디렉터리의 프로젝트를 테스트·문서 제외하고 분석합니다./understand --auto-update설정 후, 커밋마다 변경 파일만 재분석해 그래프를 최신 상태로 유지합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 Egonex-AI/Understand-Anything 의 understand-anything-plugin/skills/understand 폴더를 내 ~/.claude/skills/understand/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/Egonex-AI/Understand-Anything.git ~/understand-anything && cd ~/understand-anything && pnpm install && pnpm --filter @understand-anything/core build && mkdir -p ~/.claude/skills && cp -r understand-anything-plugin/skills/understand ~/.claude/skills/understand⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비: Node.js 22 이상과 pnpm 10 이상을 설치합니다. (
node -v,pnpm -v로 확인) - 저장소 클론:
git clone https://github.com/Egonex-AI/Understand-Anything.git ~/understand-anything - 빌드:
cd ~/understand-anything && pnpm install && pnpm --filter @understand-anything/core build - 스킬 복사:
mkdir -p ~/.claude/skills && cp -r understand-anything-plugin/skills/understand ~/.claude/skills/understand - Claude Code 재시작 후 분석하려는 프로젝트 폴더에서
/understand를 실행합니다. - 처음 실행 시
.ua/.understandignore검토 요청이 뜨면 제외할 경로를 확인하고 "계속"이라고 답합니다. - 파일이 100개를 넘으면 시간이 오래 걸리므로
/understand src처럼 하위 디렉터리를 지정해 범위를 좁히는 것을 권장합니다.
GitHub에서 원본 보기 ↗라이선스: MIT