리서치 스킬
기술 문제를 효율적으로 조사하고 배운 내용을 문서화하여 팀이 동일한 주제를 두 번 다시 조사하지 않도록 합니다.
1. 주제 범위 설정
사용자 메시지에서 다음 항목을 추출합니다(진정으로 불명확할 때만 질문):
- 주제 슬러그(Topic slug): 케밥-케이스 폴더 이름, 예:
bluetooth-audio-routing - 스택(Stack): 플랫폼/언어/프레임워크
- 증상(Symptom): 관찰된 동작 대 기대 동작
- 알려진 내용(Known): 이미 시도된 가설
2. 작업 공간 준비
scripts/init-research.sh {topic-slug} 명령어를 실행하여 docs 폴더를 생성합니다.
3. 기본 에이전트 3개를 병렬로 실행
각 에이전트는 한 줄의 접근 방향과 공유 컨텍스트를 받습니다. 정확한 프롬프트 문구가 필요하면 reference/agent-prompts.md를 참조하세요.
- 코드베이스 분석(탐색 에이전트) — 관련 코드, 갭, 파일:라인 참조를 찾습니다.
- 근본 원인 추론(웹 에이전트) — OS/프레임워크/프로토콜 수준에서 발생 이유를 분석합니다.
- 해결책 및 검증(웹 에이전트) — 네이티브 API, 라이브러리, 커뮤니티에서 확인된 수정 사항을 찾습니다.
선택적 4번째/5번째 에이전트는 사용자가 명시적으로 라이브러리 비교 또는 크로스 플랫폼 API 심층 분석을 요청한 경우에만 실행합니다.
4. 종합 정리
정확히 다음 두 파일을 생성합니다:
docs/{topic}/NOTAS.md— 원시 조사 결과, 스니펫, URL, 빠른 관찰 내용.docs/{topic}/RESEARCH_CONSOLIDADO.md— 구조화된 마스터 문서.
전체 템플릿이 필요할 때만 reference/consolidated-template.md를 사용하세요.
선택적 세부 파일(03_android_api.md, 04_librerias.md 등)은 조사 결과가 정당화하는 경우에만 생성합니다.
5. 최종화
scripts/finalize-research.sh {topic-slug} 명령어를 실행하여 마스터 문서가 존재하는지 확인하고 반복 행을 추가합니다. 그런 다음 사용자에게 보고합니다:
- 근본 원인(해당 시 파일:라인 포함)
- 덜 명확하지만 중요한 상위 3가지 발견
- 생성된 파일 목록
- 제안된 다음 단계
채팅 보고서는 간결하게 유지하며, 상세 내용은 문서에 담깁니다.