search-drill-iterate은(는) 무엇을 하나요?
하위 에이전트를 통한 반복 심층 리서치. 각 반복은 문서의 구조화된 섹션을 파싱하여 가장 가치 있는 격차를 대상으로 삼으며 이전 반복을 기반으로 구축됩니다.
사용 시기
- 주제에 대한 심층적 / 철저한 / 포괄적인 연구
- 연구 문서 작성 또는 개선
- 기존 연구 파일에 추가 패스 실행
입력
| 입력 | 필수 | 설명 |
|---|
| 주제 | 예 | 연구할 내용 |
| 연구 문서 | 아니오 | 기존 문서 경로 (없으면 생성됨) |
| 반복 횟수 | 예 | 실행할 패스 수 |
작동 방식
- 오케스트레이터가 입력을 받아
templates/pass.md 템플릿을 채웁니다.
- 각 반복에 대해 채워진 템플릿으로 하위 에이전트가 생성됩니다.
- 하위 에이전트가 문서를 읽고, 스키마 섹션을 파싱하며, 격차를 연구하고 문서를 업데이트합니다.
- 다음 하위 에이전트는 이전 에이전트가 중단한 지점에서 시작합니다. 문서가 유일한 핸드오프 수단입니다.
문서 스키마
모든 연구 문서는 이 스키마를 따릅니다. 하위 에이전트 템플릿은 각 에이전트가 이를 파싱하고 업데이트하는 방법을 가르칩니다.
---
title: ...
topic: ...
created: ...
last-updated: ...
pass: N
status: draft | complete
---
## Findings
주제별로 구성된 연구 콘텐츠. 핵심 출력물입니다. 하위 에이전트는
추가, 확장, 정제만 수행하며 이전 Findings를 절대 삭제하지 않습니다.
## Investigated Paths
검색한 내용과 그 결과를 기록합니다. 하위 에이전트는 모든 검색 전에
이를 확인하여 재연구를 방지합니다.
- `<쿼리 또는 접근 방식>` → `<결과>`
## Decision Log
연구 중 내린 결정과 그 근거를 기록합니다. 향후 패스가 왜 어떤 것이
우선순위가 높거나 낮았는지 이해하는 데 도움이 됩니다.
- [패스 N] <결정> — <근거>
## Open Questions
채워야 할 격차들입니다. 각 항목에는 시도한 내용에 대한 맥락이 포함됩니다.
진정으로 답할 수 없는 격차는 UNFILLABLE: <이유>로 표시됩니다.
이 섹션들이 중요한 이유
| 섹션 | 목적 |
|---|
| Findings | 실제 연구 결과 — 읽게 될 내용 |
| Investigated Paths | 재연구 방지 — 라운드 낭비의 #1 원인 차단 |
| Decision Log | 추론을 보존하여 향후 패스가 정보에 기반한 트레이드오프를 할 수 있도록 함 |
| Open Questions | 핸드오프 — 다음 패스에 정확히 어디에 집중해야 할지 알려줌 |
템플릿의 플레이스홀더
| 플레이스홀더 | 설명 |
|---|
<RESEARCH_FILE> | 연구 문서의 절대 경로 (없으면 생성됨) |
<TOPIC> | 일반 언어로 된 연구 주제 |
<SCOPE> | 범위 내 항목 |
<EXCLUSIONS> | 범위 외 항목 |
<RESEARCH_QUESTIONS> | 조사할 우선순위 질문들 |
파일
SKILL.md 이 파일
templates/pass.md 하위 에이전트 프롬프트 템플릿 (모든 반복에 동일한 템플릿 사용)
docs/anti-duplication.md 재연구를 방지하는 규칙
docs/logging-markers.md 감사 및 보정을 위한 구조화된 마커
examples/example-output.md 실제 문서 스키마를 보여주는 예제