OMX
Oh My CodeXv0.18.9

explore-harness

explore 에이전트를 감싸 결과를 캐싱하고 탐색 범위를 제한하는 래퍼 에이전트.

explore-harnessexplore 에이전트를 직접 호출하는 대신, 탐색 결과를 캐싱하고 범위를 제한하는 래퍼 역할을 합니다. 같은 저장소를 여러 에이전트가 반복 탐색할 때 중복 작업을 줄이고, 탐색 범위를 명시적으로 제한해 노이즈를 낮춥니다.

역할

  • explore 결과를 세션 내에서 캐싱해 반복 탐색 비용을 줄입니다.
  • 탐색 범위를 특정 디렉터리, 파일 패턴, 심볼 집합으로 제한합니다.
  • 다중 가설 조사에서 각 가설별 탐색 결과를 분리해서 관리합니다.
  • debuggerplanner가 여러 경로를 동시에 탐색할 때 병렬 탐색을 조율합니다.

언제 호출되는가

상황호출 경로
debugger가 여러 가설을 동시에 추적할 때debugger에서 위임
대형 저장소에서 반복 탐색을 피해야 할 때오케스트레이터 요청
탐색 범위를 특정 모듈로 명시적으로 좁혀야 할 때직접 요청

explore와의 차이

explore는 저장소를 넓게 탐색하는 단일 에이전트입니다. explore-harness는 그 탐색을 감싸 범위 제한결과 재사용을 추가합니다. 단순 탐색이면 explore로 충분하고, 반복·병렬 탐색이 필요한 복잡한 조사 상황에서 explore-harness가 값어치를 냅니다.

제한 사항

  • 파일을 생성, 수정, 삭제하지 않습니다.
  • 아키텍처 판단이나 수정 권고는 하지 않습니다.
  • 캐시는 세션 내에서만 유효합니다.

관련 에이전트

  • exploreexplore-harness가 감싸는 기본 탐색 에이전트.
  • debugger — 다중 가설 조사에서 explore-harness를 활용합니다.
  • planner — 탐색 결과를 바탕으로 작업 순서를 세웁니다.

목차