explore-harness
explore 에이전트를 감싸 결과를 캐싱하고 탐색 범위를 제한하는 래퍼 에이전트.
explore-harness는 explore 에이전트를 직접 호출하는 대신, 탐색 결과를 캐싱하고 범위를 제한하는 래퍼 역할을 합니다. 같은 저장소를 여러 에이전트가 반복 탐색할 때 중복 작업을 줄이고, 탐색 범위를 명시적으로 제한해 노이즈를 낮춥니다.
역할
explore결과를 세션 내에서 캐싱해 반복 탐색 비용을 줄입니다.- 탐색 범위를 특정 디렉터리, 파일 패턴, 심볼 집합으로 제한합니다.
- 다중 가설 조사에서 각 가설별 탐색 결과를 분리해서 관리합니다.
debugger나planner가 여러 경로를 동시에 탐색할 때 병렬 탐색을 조율합니다.
언제 호출되는가
| 상황 | 호출 경로 |
|---|---|
debugger가 여러 가설을 동시에 추적할 때 | debugger에서 위임 |
| 대형 저장소에서 반복 탐색을 피해야 할 때 | 오케스트레이터 요청 |
| 탐색 범위를 특정 모듈로 명시적으로 좁혀야 할 때 | 직접 요청 |
explore와의 차이
explore는 저장소를 넓게 탐색하는 단일 에이전트입니다. explore-harness는 그 탐색을 감싸 범위 제한과 결과 재사용을 추가합니다. 단순 탐색이면 explore로 충분하고, 반복·병렬 탐색이 필요한 복잡한 조사 상황에서 explore-harness가 값어치를 냅니다.
제한 사항
- 파일을 생성, 수정, 삭제하지 않습니다.
- 아키텍처 판단이나 수정 권고는 하지 않습니다.
- 캐시는 세션 내에서만 유효합니다.