Explore

개요

Explore는 코드베이스에서 파일, 코드 패턴, 심볼 간의 관계를 빠르게 찾아주는 탐색 전문 에이전트입니다. 기본 모델이 haiku라 빠르고 저렴하며, "어디에 있는지" 찾는 데 특화되어 있습니다.

Explore는 읽기 전용(read-only) 에이전트입니다. 파일을 생성하거나 수정하지 않고, 검색 결과를 메시지 텍스트로 반환합니다.

내부 코드베이스 탐색만 담당합니다. 외부 문서, 학술 논문, API 레퍼런스 등의 조회는 document-specialist가 맡습니다.

언제 쓰는가

• 특정 기능이 어떤 파일에 구현되어 있는지 찾을 때
• 코드 패턴이나 심볼의 사용처를 추적할 때
• 프로젝트 구조를 파악하고 파일 간 관계를 이해할 때
• 다른 에이전트(planner, executor 등)가 작업 전에 코드베이스 컨텍스트를 수집할 때

사용 예시

"auth 관련 코드가 어디에 있는지 찾아줘"
"이 함수를 호출하는 모든 파일을 찾아줘"
"프로젝트의 라우팅 구조를 파악해줘"

Explore는 단일 검색이 아닌 여러 각도에서 병렬 검색을 실행합니다. 예를 들어 "auth 관련 코드"를 찾을 때 컨트롤러, 미들웨어, 토큰 검증, 세션 관리 등을 동시에 검색합니다.

도구 사용

• Glob: 파일 이름/패턴으로 파일 찾기
• Grep: 텍스트 패턴으로 코드 내용 검색
• ast_grep_search: 함수 형태, 클래스 구조 등 구조적 패턴 검색
• lsp_document_symbols: 파일의 심볼 개요(함수, 클래스, 변수) 확인
• lsp_workspace_symbols: 워크스페이스 전체에서 심볼 이름 검색
• Bash: git 명령으로 히스토리/변경 이력 조회

컨텍스트 절약 전략

Explore는 컨텍스트 창을 아껴 씁니다.

• 200줄 이상 파일은 lsp_document_symbols로 개요를 먼저 확인합니다
• 500줄 이상 파일은 전체 읽기 대신 구조적 도구 우선 사용합니다
• 대용량 파일은 offset/limit 파라미터로 필요한 부분만 읽습니다
• 병렬 읽기는 한 번에 5개 파일로 제한합니다

다른 에이전트와의 조합

• planner: 계획 수립 전에 코드베이스 컨텍스트를 수집할 때 explore를 먼저 실행합니다
• executor: 구현 전에 기존 패턴과 의존성을 파악할 때 explore 에이전트를 스폰합니다
• architect: 아키텍처 분석을 위한 초기 파일 매핑에 활용합니다
• debugger: 버그 관련 코드 위치를 빠르게 찾을 때 활용합니다

레퍼런스