클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

AGF 코드맵 (심층 코드 이해)

SQLite 영속 코드 그래프와 역방향 BFS 영향 분석으로 낯선 코드베이스를 빠르게 파악하게 해주는 codemap CLI 오케스트레이터.

개발·코딩중급★ 412⑂ 14AI 점수 8/10마지막 업데이트: 2026. 7. 19.

무엇을 해주나

tools/codemap/의 codemap CLI를 Claude가 알아서 호출하도록 지휘하는 스킬입니다.

  • build/update: 전체 코드 그래프를 .agf/code-map.db(SQLite)에 만들고, git diff + 이중 지문으로 증분 갱신
  • diff: 변경분에서 역방향 import BFS를 돌려 영향 범위와 위험 점수를 산출 (코드 리뷰 체크리스트로 연결)
  • explain / onboard / understand: 특정 노드 심층 설명, 프로젝트 개요·복잡도 핫스팟·고팬인 모듈, 디렉터리 단위 이해 지도
  • search / embed / context: FTS5 키워드 검색 기본, embedding 생성 후 의미 검색 자동 활성(3단계 폴백), 에이전트 주입용 서브그래프 추출
  • dashboard: cytoscape 기반 정적 HTML 그래프 출력
  • 규율: 산출물 .agf/*는 gitignore 대상이며, 스펙·ADR·OpenAPI 계약 문서는 건드리지 않고 '사실 층'으로만 동작합니다.

지원 언어는 Python/TS/JS/SQL/YAML/JSON/Java 7종이며 Swift·WXML은 미지원임을 명시합니다.

이런 분께 추천

  • 인수인계받은 레거시 프로젝트를 Day-1에 파악해야 하는 개발자
  • PR 리뷰 시 변경의 파급 범위를 근거 있게 확인하고 싶은 리뷰어·테크리드
  • PRD/ADR 작성 전 현행 구조를 정리해야 하는 아키텍트
  • 단, AppGenesisForge 저장소의 codemap CLI(uv 실행 환경)를 함께 쓸 수 있어야 합니다.

활용 예시

  1. 레거시 인수인계: "이 저장소 처음 봅니다" → codemap build → onboard → dashboard로 복잡도 핫스팟과 의존 허브를 한눈에 확인.
  2. PR 영향 분석: "main 대비 이번 변경의 영향 범위 알려줘" → codemap diff --base main --hop 2로 역방향 의존 경로와 위험 점수 목록 확보.
  3. 낯선 함수 해설: "OrderService.settle이 뭐 하는 함수야?" → codemap explain으로 이웃 노드와 소스 조각을 함께 설명.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/pcliangx/AppGenesisForge/HEAD/.claude/skills/agf-code-map/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 pcliangx/AppGenesisForge 의 .claude/skills/agf-code-map 폴더를 내 ~/.claude/skills/agf-code-map/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/pcliangx/AppGenesisForge.git && mkdir -p ~/.claude/skills && cp -r AppGenesisForge/.claude/skills/agf-code-map ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 저장소를 클론합니다: git clone https://github.com/pcliangx/AppGenesisForge.git
  2. 스킬 디렉터리를 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r AppGenesisForge/.claude/skills/agf-code-map ~/.claude/skills/
  4. CLI 실행 환경을 준비합니다. uv를 설치한 뒤 cd AppGenesisForge/tools/codemap && uv sync 를 실행합니다.
  5. (선택) 의미 검색을 쓰려면 uv sync --extra semantic 후 uv run codemap embed를 실행합니다. 첫 실행 시 모델 약 90MB + torch가 내려받아집니다.
  6. 분석하려는 프로젝트 루트에서 uv run codemap build .로 그래프를 만들고, Claude Code를 재시작한 뒤 "이 프로젝트 구조를 파악해줘"처럼 요청하면 스킬이 발동합니다.
  7. 산출물 .agf/ 폴더는 캐시이므로 .gitignore에 추가해 두세요.
GitHub에서 원본 보기 ↗라이선스: MIT