스마트 익스플로러 (코드 구조 탐색)

무엇을 해주나

파일 전체를 읽는(Read) 대신, tree-sitter AST 파싱을 이용한 3단계 구조 탐색 워크플로를 Claude에게 강제합니다.

1. smart_search — 디렉터리를 훑어 관련 심볼(함수/클래스/메서드)과 줄 번호, 그리고 접힌(folded) 파일 구조를 한 번에 반환 (약 2~6k 토큰)
2. smart_outline — 한 파일의 골격(함수·클래스·프로퍼티·import) 추출 (약 1~2k 토큰)
3. smart_unfold — 필요한 심볼 하나의 전체 소스만 펼쳐 보기 (약 0.4~2.1k 토큰)

Glob → Grep → Read 반복 사이클을 한 번의 검색 호출로 대체하고, AST 노드 경계를 기준으로 잘라내므로 긴 메서드가 중간에 끊기지 않습니다. 문서에는 Read(1.2만 토큰+)나 Explore 에이전트(3.9~5.9만 토큰) 대비 4~18배 절약된다는 비교표까지 제시되어 있습니다.

JS/TS/TSX, Python, Go, Rust, Ruby, Java, C/C++ 문법이 기본 내장되어 있고, .claude-mem.json에 npm tree-sitter 문법을 등록하면 Solidity 같은 언어도 추가할 수 있습니다. 마크다운은 헤딩 트리 + 프론트매터까지 별도로 지원합니다.

이런 분께 추천

• 수만 줄 규모의 대형 코드베이스에서 컨텍스트 한도에 자주 부딪히는 개발자
• 리팩터링·버그 추적 전에 '이 기능이 어디에 흩어져 있는지' 먼저 파악해야 하는 분
• 토큰 사용량(비용)을 실질적으로 줄이고 싶은 팀
• 코드 기반 문서/온보딩 자료를 작성하는 테크 라이터

활용 예시

• 기능 추적: smart_search(query="shutdown", path="./src")로 7개 파일의 14개 심볼을 한 번에 확인한 뒤, performGracefulShutdown만 unfold해서 핵심 로직 확인.
• 거대 파일 탐색: 1,500줄짜리 worker-service.ts를 outline으로 훑어 12개 함수와 24개 클래스 멤버 목록을 얻고, 필요한 startSessionProcessor 메서드만 펼쳐 총 3천 토큰으로 마무리(전체 Read는 1.2만 토큰).
• 문서 작성 하이브리드: 코드는 search+outline+unfold로, 설정 파일이나 계획서(.json/.md)는 일반 Read로 섞어 쓰며 아키텍처 문서 초안 작성.

주의: 정확한 문자열/정규식 검색, 100줄 미만 파일, 6개 이상 파일에 걸친 서술형 종합 설명이 필요할 때는 스킬 문서 자체가 Grep/Read/Explore 에이전트를 쓰라고 안내합니다.

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