정보 수집이 필요할 때 검색 에이전트 활용 가이드. 코드 탐색, 레퍼런스, 웹검색
정보 수집이 필요할 때 적절한 검색 에이전트를 선택하고 활용하는 방법입니다.
/orchestrate 커맨드는 Glob, Grep, Search를 직접 사용하면 안 됩니다. 반드시 아래 검색 에이전트를 Task tool로 spawn해야 합니다.
claude --agent {agent-name} 사용 금지claude task --subagent {agent-name} 사용 금지반드시 Task tool (function call)을 사용하세요.
| 에이전트 | 용도 | 모델 |
|---|---|---|
| codebase-search-agent | 프로젝트 내 코드 탐색 | Sonnet |
| reference-agent | 예제/템플릿 코드 탐색 | Haiku |
| web-search-agent | 외부 문서/API 레퍼런스 | Haiku |
중요: 반드시 Task tool을 사용합니다. Bash 명령어로 실행하지 마세요.
용도:
Spawn 예시:
Task tool 호출:
subagent_type: "codebase-search-agent"
run_in_background: true
prompt: |
사용자 인증 관련 코드를 찾아줘. 로그인, 세션, 토큰 관련 파일과 함수를 파악해줘.
.claude/agents/codebase-search-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘.
용도:
Spawn 예시:
Task tool 호출:
subagent_type: "reference-agent"
run_in_background: true
prompt: |
API 엔드포인트 구현 예제를 찾아줘. examples/, samples/ 폴더와 README를 확인해줘.
.claude/agents/reference-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘.
용도:
Spawn 예시:
Task tool 호출:
subagent_type: "web-search-agent"
run_in_background: true
prompt: |
React 18의 useEffect 변경사항에 대해 검색해줘. 공식 문서 위주로 찾아줘.
.claude/agents/web-search-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘.
시간 단축을 위해 동시에 Task tool 호출 (단일 메시지에 여러 호출):
Task tool #1:
subagent_type: "codebase-search-agent"
run_in_background: true
prompt: "프로젝트 내 관련 코드 탐색..."
Task tool #2:
subagent_type: "reference-agent"
run_in_background: true
prompt: "예제/템플릿 탐색..."
Task tool #3 (필요시):
subagent_type: "web-search-agent"
run_in_background: true
prompt: "외부 문서 검색..."