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 동시 실행
• 증거 기반: 모든 결과에 소스 경로 명시
• 점진적 심화: 초기 결과 기반 추가 탐색
• 범위 제한: 목표와 무관한 결과 필터링