| name | deep-search |
| description | 다중 전략 코드베이스 심층 탐색 워크플로우. Grep, SemanticSearch, Glob를 병렬로 실행하여 심볼, 패턴, 의존성을 종합적으로 분석. Use when performing deep codebase analysis or when searching for complex code patterns and dependencies. |
Deep Search — 다중 전략 코드베이스 탐색
다양한 검색 전략을 병렬로 실행하여 코드베이스를 심층 탐색합니다.
단일 검색으로는 찾기 어려운 관계, 패턴, 숨겨진 의존성을 발견합니다.
참조 룰
Read tool로 읽어 적용:
.claude/skills/code-accuracy/SKILL.md — 심볼 존재 확인 + 라이브러리 API 검증
4-Step 워크플로우
Step 1: 탐색 목표 정의
- 무엇을 찾는가? (심볼, 패턴, 관계, 영향 범위)
- 어디서 찾는가? (전체/특정 모듈/특정 레이어)
- 왜 찾는가? (구현 참조, 영향 분석, 의존성 파악)
Step 2: 병렬 3-Track 검색
Track A — 정확 매칭 (Grep): 타입명, 심볼명, import/use 패턴으로 정확 검색
Track B — 의미 검색 (SemanticSearch): "이 기능은 어떻게 구현되어 있는가?" 형태의 질문
Track C — 파일 패턴 (Glob): 네이밍 컨벤션, 디렉터리 구조 기반 파일 탐색
3개 Track은 반드시 동시 실행합니다.
Step 3: 의존성 추적
- import/use 관계 그래프, 순환 참조 탐지
- 프로토콜/인터페이스 채택 관계
- 타입 참조 (파라미터, 리턴, 프로퍼티)
Step 4: 구조화 리포트
발견 파일, 의존성 관계(Mermaid), 주요 발견, 영향 범위, 추가 탐색 권장 항목을 정리합니다.
시나리오별 전략
Feature 구현 전: 유사 구현 검색, API/Repository 확인
리팩토링 전: 수정 대상 참조처, 상속/프로토콜 체인, 테스트 참조
버그 추적: 에러 메시지/타입 검색, 호출 체인 추적
레거시 분석: 혼용 패턴, 브릿징 참조, 레거시 코드 위치 파악
원칙
- 병렬 우선: 3-Track 동시 실행
- 증거 기반: 모든 결과에 소스 경로 명시
- 점진적 심화: 초기 결과 기반 추가 탐색
- 범위 제한: 목표와 무관한 결과 필터링
