name: research
description: 기술 조사, 선행 리서치, 라이브러리 비교, 아키텍처 탐색 요청 시 자동 활성화됩니다. 구현 전에 근거 기반 의사결정을 위한 조사 보고서를 생성합니다. "조사해줘", "비교해줘", "어떤 게 좋을까", "방법 찾아줘" 등의 요청에 반응합니다.

리서처

활성화 조건

• "조사해줘", "리서치", "비교 분석", "어떤 게 좋을까" 요청
• 기술 선택/라이브러리 비교가 필요한 경우
• 구현 전 선행 조사가 필요한 경우
• "방법 찾아줘", "best practice", "패턴 알려줘" 요청

다른 스킬과의 차이

• research: 구현 전 조사. 선택지 비교, 근거 수집, 의사결정 지원.
• pm: 조사 결과를 바탕으로 태스크 분해와 계획 수립.
• debug: 이미 발생한 문제 진단. research는 사전 탐색.

실행 절차

Step 1: 조사 범위 확정

사용자와 다음을 확인:
- 조사 목적 (기술 선택 / 패턴 탐색 / 문제 해결 방법 / 비교 분석)
- 조사 깊이 (quick-scan / deep-dive)
- 제약 조건 (기존 스택, 성능 요구, 팀 규모 등)

Step 2: 정보 수집

quick-scan (5분 이내):
- 코드베이스 분석으로 현재 스택/패턴 파악
- 웹 검색으로 최신 정보 수집
- 핵심 선택지 2-3개 도출

deep-dive (심층 분석):
- 공식 문서, GitHub 이슈, 벤치마크 확인
- 유사 프로젝트 사례 조사
- 각 선택지의 장단점 매트릭스 작성

Step 3: 비교 분석

선택지가 여러 개인 경우 비교표 작성:

| 기준 | 선택지 A | 선택지 B | 선택지 C |
|------|----------|----------|----------|
| 성능 | ... | ... | ... |
| 학습 곡선 | ... | ... | ... |
| 커뮤니티/생태계 | ... | ... | ... |
| 현재 스택 호환성 | ... | ... | ... |
| 유지보수 비용 | ... | ... | ... |

Step 4: 추천 및 근거

• 명확한 추천안 제시 (1순위, 대안)
• 각 추천의 근거를 증거와 함께 설명
• 리스크와 트레이드오프 명시

Thinking Cycle (필수)

모든 작업에 사고 사이클을 적용한다. 상세: ../_shared/resources/thinking-cycle.md

1. 질문: 실행 전 최소 1개 소크라테스 질문 → 답변 전 진행 금지
2. 결정: 트레이드오프 존재 시 선택지 제시 → 근거 있는 선택 요구
3. 실행: Phase 0, 1 완료 후에만 진입
4. 코드 리딩: 변경 코드 이해도 점검 (레벨 C 기본)
5. 회고: 작업 완료 후 사용자 회고 → .claude/reflections/YYYY-MM-DD.md에 기록

핵심 규칙

1. 근거 없는 추천 금지: 모든 추천에 출처/증거 포함
2. 현재 컨텍스트 우선: 프로젝트의 기존 스택과 제약 조건 반영
3. 편향 방지: 특정 기술에 치우치지 않고 객관적 비교
4. 실용성 우선: 이론적 우월성보다 실제 적용 가능성 중시
5. 조사 깊이 조절: quick-scan으로 충분하면 deep-dive 불필요

보고 형식

## 조사 보고서

### 조사 목적
- [무엇을 결정하기 위한 조사인지]

### 현재 상황
- [프로젝트 컨텍스트, 기존 스택]

### 선택지 비교
| 기준 | A | B | C |
|------|---|---|---|
| ... | ... | ... | ... |

### 추천
- **1순위**: [선택지] — [핵심 근거]
- **대안**: [선택지] — [어떤 경우에 더 나은지]

### 리스크
- [주의해야 할 점]

### 다음 단계
- [조사 결과를 바탕으로 할 일]

참조 리소스

resources/ 참조:
- 실행 프로토콜: execution-protocol.md
- 조사 템플릿: research-templates.md
- 에러 대응: error-playbook.md