Nexus Mapper — AI용 코드베이스 지도 생성기

무엇을 해주나

• Tree-sitter 기반 AST 추출과 Git 이력 분석을 결합해 저장소 구조를 체계적으로 조사합니다.
• 결과물로 .nexus-map/ 디렉터리를 생성합니다: 冷스타트 진입점 INDEX.md(2000토큰 이내), 시스템 경계 arch/systems.md, Mermaid 의존성 그래프 arch/dependencies.md, 테스트 커버리지 요약, 기계 판독용 concepts/concept_model.json, Git 핫스팟/결합 분석 hotspots/git_forensics.md, 원본 데이터(raw/).
• PROBE(탐사→가설→반박→검증→출력) 단계 게이트를 강제해 "디렉터리 이름만 보고 추측"하는 것을 막고, 증거가 없는 노드는 planned/inferred로 표기하도록 규칙화합니다.
• 30여 개 언어를 확장자 기준으로 자동 처리하고, 미지원 언어는 --add-extension, --add-query, --language-config로 보강할 수 있습니다.
• 출력 원자성(.tmp/에 먼저 쓰고 통째로 이동), 재실행 시 덮어쓰기 확인, .env·키 파일의 값은 기록하지 않는 보안 규칙까지 포함합니다.

이런 분께 추천

• 인수인계받은 레거시 저장소나 오픈소스 리포를 빠르게 파악해야 하는 개발자
• 대규모 리팩터링·모듈 경계 재설계를 앞두고 영향 범위를 근거 있게 정리해야 하는 팀
• 팀 전체가 AI 세션을 매번 처음부터 설명하지 않고 시작하도록 공통 컨텍스트를 두고 싶은 조직

활용 예시

1. "이 저장소 분석해서 프로젝트 지식베이스 만들어줘" → .nexus-map/INDEX.md 이하 문서 세트가 생성되고, 이후 새 AI 세션은 INDEX만 읽고 바로 작업 가능.
2. 공용 함수 이름을 바꾸기 전에 query_graph.py --impact src/core/auth.py --git-stats raw/git_stats.json으로 영향 반경과 변경 위험도를 확인.
3. Django 정적 파일 등 잡음 디렉터리를 --exclude-dirs django_static,third_party/assets로 제외하고 AST를 다시 추출해 파일 트리를 정리.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/Haaaiawd/Nexus-skills/HEAD/skills/nexus-mapper/SKILL.md

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

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