researcher
외부 문서, SDK 레퍼런스, 라이브러리 스펙을 조사해 구현에 필요한 정보를 가져오는 Domain 에이전트.
개요
researcher 에이전트는 외부 문서와 레퍼런스를 조사합니다. SDK 사용법, 라이브러리 API 스펙, 서비스 제약 조건처럼 코드베이스 안에 없는 정보가 필요할 때 호출합니다. 구현 전에 정확한 정보를 확보하는 역할이라, executor가 추측으로 코드를 쓰는 상황을 줄여줍니다.
언제 쓰는가
- 처음 쓰는 SDK나 라이브러리의 정확한 사용법을 확인해야 할 때
- 외부 서비스 API의 제약 조건, rate limit, 인증 방식을 파악해야 할 때
- 최신 문서와 트레이닝 데이터 기준 정보가 다를 수 있어 공식 레퍼런스를 확인해야 할 때
$external-context나$document-specialist를 통해 병렬 문서 조사가 필요할 때
사용 예시
"Stripe Webhooks 검증 방법을 공식 문서 기준으로 조사해줘"
"Next.js App Router에서 middleware 설정 방법을 찾아줘"
"이 라이브러리 v3에서 v4 마이그레이션 방법을 조사해줘"조사 범위
| 항목 | 내용 |
|---|---|
| SDK / 라이브러리 | 공식 레퍼런스, 함수 시그니처, 설정 옵션 |
| 외부 서비스 API | 엔드포인트 스펙, 인증 방식, 제약 조건 |
| 마이그레이션 가이드 | 버전 변경 사항, breaking change, 업그레이드 절차 |
| 모범 사례 | 공식 권장 패턴, 알려진 주의사항 |
작업 프로세스
- 무엇을 알아야 하는지 조사 대상을 명확히 합니다.
- 공식 문서나 레퍼런스를 우선 확인합니다.
- 필요한 경우 context7 같은 문서 도구를 활용합니다.
- 조사 결과를 요약하고 구현에 바로 쓸 수 있는 형태로 정리합니다.
입력
- 조사할 라이브러리, SDK, 서비스 이름
- 구체적으로 확인해야 할 API나 기능
- 구현에서 막힌 부분이나 불확실한 부분
출력
- 공식 문서 기반의 정확한 사용법 요약
- 함수 시그니처, 설정 옵션, 예시 코드
- 알려진 제약 조건이나 주의사항
- 참고 출처 링크
제한 사항
- 직접 코드를 작성하지 않습니다. 정보를 제공하고
executor가 구현합니다. - 공식 문서가 없는 경우 불확실성을 명시합니다.
- 내부 코드베이스 탐색은
explore가 담당합니다.
관련 에이전트
- executor — researcher가 가져온 정보를 바탕으로 실제 구현합니다.
- dependency-expert — SDK/패키지 선택과 버전 판단을 담당합니다.
- explore — 내부 코드베이스 탐색과 파일 구조 파악을 담당합니다.