pre-work-research

PRE_WORK Research

신규 기능 구현 전 필수 사전 조사 워크플로우입니다.

Quick Start

# GitHub 오픈소스 검색
python .claude/skills/pre-work-research/scripts/github_search.py "검색 키워드"

# Make vs Buy 분석 템플릿 생성
python .claude/skills/pre-work-research/scripts/github_search.py --analyze "기능명"

워크플로우

사용자 요청
    ↓
1. 오픈소스 검색 (MIT/Apache/BSD, Stars>500)
    ↓
2. 중복 확인 (gh issue/pr list)
    ↓
3. Make vs Buy 분석
    ↓
4. 사용자 승인
    ↓
구현 진행 (Phase 1)

Step 1: 오픈소스 검색

검색 우선순위

MCP 활용

# Exa 검색 (mcp__exa__search)
mcp__exa__search(query="Python logging library best 2025")

# Context7 문서 검색 (mcp__ref__search)
mcp__ref__search(query="FastAPI authentication patterns")

평가 체크리스트

• 라이선스 호환성 (MIT/Apache/BSD)
• 활성 유지보수 (최근 6개월 내 커밋)
• 커뮤니티 규모 (Stars, Issues 응답률)
• 문서화 품질
• 의존성 개수

Step 2: 중복 확인

# 기존 이슈 확인
gh issue list --search "feature-name" --state all

# 기존 PR 확인
gh pr list --search "feature-name" --state all

# 관련 브랜치 확인
git branch -a | grep -i "feature-name"

중복 발견 시

1. 기존 이슈/PR 링크 첨부
2. 재사용 가능 여부 검토
3. 필요 시 기존 작업 확장

Step 3: Make vs Buy 분석

분석 템플릿

## Make vs Buy 분석: [기능명]

### Option A: 직접 개발 (Make)
- **예상 시간**: X일
- **복잡도**: 높음/중간/낮음
- **장점**: 커스터마이징 자유, 의존성 감소
- **단점**: 유지보수 부담, 개발 시간

### Option B: 오픈소스 활용 (Buy)
- **후보**: [라이브러리명] (Stars: X, License: MIT)
- **통합 시간**: X일
- **장점**: 검증된 솔루션, 커뮤니티 지원
- **단점**: 의존성 추가, 커스터마이징 제한

### 권장사항
[A 또는 B] 권장

**이유**: [구체적 근거]

의사결정 기준

Step 4: 사용자 승인

분석 결과를 사용자에게 제시하고 승인을 받습니다.

## PRE_WORK 결과 요약

### 검색 결과
- 후보 1: [라이브러리A] - Stars: 5k, License: MIT
- 후보 2: [라이브러리B] - Stars: 3k, License: Apache 2.0

### 중복 확인
- 관련 이슈: 없음 / #123 (유사)
- 관련 PR: 없음 / #456 (관련)

### 권장사항
[Buy: 라이브러리A 사용] / [Make: 직접 개발]

### 다음 단계
승인 시 Phase 1 (구현) 진행

**승인하시겠습니까? (Y/N)**

관련 도구

관련: CLAUDE.md 섹션 3 Workflow