SKILL.md
Research Context
활성화 조건
- 기술 조사
- 라이브러리/프레임워크 비교
- 아키텍처 결정
우선순위
- 정확성 (검증된 정보)
- 최신성 (업데이트된 정보)
- 관련성 (질문과 직접 연관)
지식 계층 분류
조사 결과를 다음 3계층으로 분류하여 보고한다.
Layer 1: Tried and True (검증된 표준)
- 표준 패턴, 공식 문서, 안정적 API
- 위험: "당연히 맞겠지"로 전제를 검증하지 않는 것
- 출처: 공식 문서, 릴리즈 노트, API 레퍼런스, RFC
Layer 2: New and Popular (최근 트렌드)
- 블로그, 벤치마크, 생태계 트렌드
- 위험: 유행 편향 -- 검색 결과는 답이 아니라 판단의 입력
- 출처: 기술 블로그, GitHub 이슈/토론, StackOverflow, 벤치마크
- 비판적 수용 필수: 근거/조건/재현성을 확인 후 채택
Layer 3: First Principles (원칙 기반 추론)
- 문제 자체에서 도출한 독자적 관찰
- Layer 1+2를 검토한 후, 기존 접근의 전제가 현재 상황에 맞지 않을 때 적용
- 가장 가치 있는 결과: "왜 통상적 접근이 여기서는 틀린가"를 설명할 수 있을 때
보고 형식
각 조사 항목에 계층을 표기한다:
[L1] Go의 context.Context는 취소 전파에 사용 (공식 문서)
[L2] slog가 zerolog 대비 벤치마크에서 10% 느림 (블로그, 조건부)
[L3] 이 프로젝트에서는 structured logging이 불필요 -- 로그 소비자가 없음검색 전략
1순위: 공식 문서 (Layer 1)
- 릴리즈 노트
- API 문서
- 마이그레이션 가이드
2순위: 신뢰 출처 (Layer 1-2)
- 공식 블로그
- GitHub 이슈/토론
- 벤치마크 결과
3순위: 커뮤니티 (Layer 2)
- StackOverflow (고득표)
- 기술 블로그
정확도 표시
- 확인됨: 공식 문서 기반
- 확인 불가: 모든 검색 수단 소진 후에도 검증 불가능할 때만 사용
- 추측: 모든 검색 수단 소진 후 상황 기반 추론이 필요할 때만 사용
주의사항
- 검색 결과는 판단의 입력이지 답 자체가 아님
- Layer 2 결과를 무비판적으로 수용하지 않음 (유행 편향 경계)
- Layer 1이 존재할 때 Layer 2를 우선하지 않음
- Layer 3 추론은 Layer 1+2 검토 후에만 시도
- 관련성 낮은 결과 폐기
- 출처 자연스럽게 통합