SP 02 RESEARCH

# Stage 2 Prompt: 리서치 및 사전 조사

> Spec-Contract v5.0 | Cycle: 초기
> Stage Prompt ID: SP-02

---

## CONTEXT

- **현재 위치:** 초기 Cycle > Stage 2
- **이전 Stage:** Stage 1 프로젝트 기초 설정 (산출물: CLAUDE.md, Project_Requirement.md, Tech_Stack_Analysis.md, conventions/)
- **다음 Stage:** Stage 3 스펙 문서 작성
- **프로덕트 모드:** Stage 0의 `00_STAGE_SKIP_DECISION.md`에서 수행 판정 확인. 스킵 또는 부분 수행일 수 있음

이 Stage는 확정된 기술 스택에 대한 심층 리서치를 수행합니다. v4.0에서 "사람이 먼저 이해한 뒤 AI에 동기화"였던 원칙을, v5.0에서는 Agent가 웹 검색 + 공식 문서 분석으로 자율 수행하는 구조로 전환합니다.

---

## OBJECTIVE

확정된 기술 스택에 대한 공식 문서 리서치, 기술 제약 파악, 레퍼런스 패턴 수집을 수행하여 Stage 3 설계의 기반을 마련합니다.

**성공 기준:**
1. `Tech_Stack_Official_Docs_Research.md`에 기술별 최신 권장 사항, API 변경점, 알려진 이슈가 정리됨
2. `Tech_Constraints_and_Dependencies.md`에 제약 사항이 C-01부터 번호를 매겨 체계적으로 정리됨 (라이선스 위험도 포함)
3. `Reference_Patterns.md`에 패턴(P-xx)과 안티패턴(AP-xx)이 코드 예시와 함께 수록됨
4. `conventions/domain-model.md`에 도메인 엔티티, 관계, 상태 머신이 기술됨

---

## CONSTRAINTS

**MUST DO:**
- [ ] 활동 2-1: 기술 스택별 공식 문서를 웹 검색으로 조사. 최신 버전의 권장 사항, Breaking Changes, 마이그레이션 가이드를 수집
- [ ] 활동 2-2: 기술 제약(무료 티어 제한, 호환성, 라이선스, 배포 제약)을 C-xx 번호로 체계화. 라이선스 위험도(🔴 High/🟡 Medium/🟢 Low) 분류 포함
- [ ] 활동 2-3: 검증된 구현 패턴을 P-xx 번호로, 안티패턴을 AP-xx 번호로 수집. 각 패턴에 코드 스니펫(TypeScript/해당 언어) 예시 포함
- [ ] 활동 2-4: 요구사항 + 기술 스택에서 도메인 모델(ER, 상태 머신, RBAC 등) 초안 작성
- [ ] Reference_Patterns.md는 ♻️ Reusable 등급 — 프로젝트 특정 코드가 아닌 범용 패턴으로 작성
- [ ] Tech_Stack_Official_Docs_Research.md는 ♻️ Reusable 등급 — 기술별 분리 가능하도록 섹션 구조화

**MUST NOT DO:**
- [ ] 비공식 블로그나 검증되지 않은 소스를 공식 권장으로 제시하지 않음
- [ ] 패턴 수집 시 코드를 복사하지 않고 패턴의 구조와 원리를 기술
- [ ] Stage 3의 설계 결정(아키텍처, UC 정의)을 이 Stage에서 선행하지 않음

**SCOPE:**
- 기술 리서치 + 제약 파악 + 패턴 수집 + 도메인 모델 초안만
- 아키텍처 결정, UC 정의, Phase 분해는 Stage 3 범위

---

## INPUT ARTIFACTS

| ID | 파일 경로 | 참조 내용 |
|----|----------|----------|
| A-010 | `docs/Project_Requirement.md` | 프로젝트 목적, 핵심 기능 → 도메인 모델 도출 |
| A-011 | `docs/Tech_Stack_Analysis.md` | 확정 기술 스택 → 리서치 대상 |
| A-023 | `CLAUDE.md` | 하드 바운더리 → 금지 기술 확인 |

---

## OUTPUT ARTIFACTS

| ID | 파일 경로 | 형식 | 등급 | 설명 |
|----|----------|------|:----:|------|
| A-030 | `docs/Tech_Stack_Official_Docs_Research.md` | 📄 MD | ♻️ | 기술별 공식 문서 요약 + 참조 URL |
| A-031 | `docs/Tech_Constraints_and_Dependencies.md` | 📄 MD | 🏛️ | C-xx 제약 목록 + 라이선스 위험도 |
| A-032 | `docs/Reference_Patterns.md` | 📄 MD | ♻️ | P-xx 패턴 + AP-xx 안티패턴 + 코드 예시 |
| A-033 | `docs/conventions/domain-model.md` | 📄 MD | 🏛️ | ER 다이어그램, 상태 머신, RBAC, API 설계 |

---

## EXECUTION RULES

1. **세션 규칙:** 단일 세션에서 활동 2-1~2-4 순차 수행
2. **웹 검색 전략:**
   - 공식 문서 우선 (*.dev, *.io, github.com/[org]/[repo])
   - npm/pypi 패키지 README + CHANGELOG 확인
   - 최신 버전의 Breaking Changes 반드시 확인
3. **패턴 수집 기준:**
   - 공식 예제 코드 > 커뮤니티 Best Practice > 블로그
   - 각 패턴에 "언제 사용하는가" + "언제 사용하지 않는가" 명시
4. **라이선스 분류 기준:**
   - 🔴 AGPL, GPL, SSPL, NOASSERTION → 즉시 조치
   - 🟡 LGPL, MPL, EPL → 사용 방식 검토
   - 🟢 MIT, Apache-2.0, BSD → 고지 의무만
5. **완료 확인:** A-030~A-033 전체 생성 확인
6. **다음 Stage:** Stage 3 (스펙 문서 작성)

---

*Stage 2 Prompt — Spec-Contract v5.0*