explore

explore 에이전트가 답하는 질문은 하나입니다. "X가 대체 어디 있지?" 다른 어떤 에이전트가 코드에 손대기 전에 먼저 움직여, 저장소를 넓게 훑다가 점점 좁혀 가는 병렬 검색으로 파일 경로와 심볼 위치, 호출 관계까지 구조화해 돌려줍니다. 오직 읽기만 하기 때문에 워크플로우 어느 지점에 끼워 넣어도 부작용이 없습니다.

역할

• 질문과 관련된 파일, 디렉터리, 모듈 경계를 파악합니다.
• 함수, 클래스, 타입 같은 심볼 위치와 파일 간 관계를 찾습니다.
• 진입점, dependency chain, import graph를 식별합니다.
• Glob, Grep, AST search, LSP 결과를 교차 검증해 false positive를 줄입니다.

언제 호출되는가

입력

• 저장소 루트 경로
• 검색 질의 또는 범위 힌트 (심볼 이름, 기능 영역, 파일 패턴, 자유 형식 설명)
• 선택적으로 에러 메시지, 이미 알고 있는 파일 경로

출력

• 절대 파일 경로, 매칭된 심볼, 관계 요약이 담긴 in-session 보고서
• deep-search 실행에서는 .omx/research/<topic>.md에 결과를 남겨 다른 에이전트가 참고할 수 있습니다.
• 이어서 어떤 에이전트가 작업해야 하는지 알려주는 next_steps 섹션

제한 사항

• 파일을 생성, 수정, 삭제하지 않습니다.
• 테스트 실행, 빌드, 코드 품질 평가는 담당하지 않습니다.
• 아키텍처 권고는 하지 않습니다. 그 역할은 architect입니다.

관련 에이전트

• analyst — explore 결과를 바탕으로 요구사항을 정리합니다.
• planner — explore가 찾은 파일·모듈 지도를 바탕으로 작업 순서를 세웁니다.
• debugger — 증상 위치를 찾을 때 explore를 활용합니다.
• executor — 수정 전에 explore와 planner가 정리한 파일 목록을 입력으로 받습니다.