name: research description: 다각도 분해 + 병렬 검색으로 외부 정보 조사 argument-hint: [research question]
Research
질문을 독립 관점으로 분해하고 병렬 검색하여 소스 인용 포함 종합 보고서를 생성한다.
언제 사용
- 기술 비교 (예: "Prisma vs Drizzle ORM")
- 라이브러리/프레임워크 선택
- 경쟁사/시장 분석
- 디버깅 시 근본 원인 조사
- 외부 정보가 필요한 모든 상황
사용하지 말 것
- 코드베이스 내부 조사 → Grep/Glob 직접 사용
- 아이디어 정리 →
/ina:think - 단순 질문 → 직접 대화
ina 연동
ina 데몬에 의해 실행된 경우:
- 다각도 분해 후:
ina_report_progress(in_progress="관점 N개 병렬 검색 중", remaining="종합") - 종합 시작:
ina_report_progress(in_progress="종합 보고서 작성", completed="관점 검색") - 3-strike:
ina_mark_blocked(reason="검색 3회 연속 실패 — 검색어 조정 필요")
흐름
>>> Stage 1: 다각도 분해
질문을 2-5개 독립적인 검색 관점으로 분해한다.
예시: "Next.js vs Remix for our project" → 관점 1: Next.js 핵심 기능 및 장단점 → 관점 2: Remix 핵심 기능 및 장단점 → 관점 3: 성능 벤치마크 비교 → 관점 4: 커뮤니티 크기 및 생태계
>>> Stage 2: 병렬 검색
각 관점을 별도 Agent로 병렬 실행:
Agent(prompt="관점 N에 대해 조사: ...", description="Research facet N")
각 Agent는:
- WebSearch로 관련 정보 검색
- WebFetch로 공식 문서, 블로그, GitHub 확인
- 소스 URL 인용 필수
>>> Stage 3: 종합
모든 관점 결과를 종합하여 보고서 작성:
- 관점별 핵심 발견
- 비교 테이블 (해당 시)
- 추천 및 근거
- 모든 소스 URL 인용
>>> 3-Strike Rule
검색이 3회 연속 유용한 결과를 찾지 못하면:
ina_mark_blocked(reason="검색 3회 연속 실패")(데몬 연동 시)- 즉시 멈추고 현재까지의 결과를 보고
- "추가 검색이 필요하면 검색어를 조정해주세요"라고 제안
출력물
- 종합 보고서:
docs/{YYYYMMDD-HHMM}-research-{slug}.md
입출력
- 입력: 자연어 조사 질문
- 출력:
docs/{YYYYMMDD-HHMM}-research-{slug}.md