---
name: show-me-the-prd
description: 인터뷰 기반 PRD 생성 스킬. "/show-me-the-prd", "PRD 만들어줘", "기획서 만들어줘", "쇼미더피알디", "앱 기획해줘", "서비스 기획" 같은 요청에 사용됩니다. 바이브코더를 위해 한 문장 아이디어에서 4종 디자인 문서(PRD, 데이터 모델, Phase 분리, 프로젝트 스펙)를 생성합니다.
---

# Show Me The PRD -- 인터뷰 기반 PRD 생성

> 한 문장 아이디어 -> 5-6번 인터뷰 -> 4종 디자인 문서 완성
> 바이브코더가 개발 지식 없이도 "진짜 제품"을 만들 수 있는 기획 문서를 생성한다.

## 핵심 원칙

1. **바이브코더 눈높이** -- 기술 용어 금지. 모든 선택지에 설명 + 장단점 필수.
2. **AI가 리드, 유저가 결정** -- 유저가 아는 것(목적, 대상)은 질문으로 끌어내고, 모르는 것(기술, 구조)은 AI가 조사해서 선택지로 제안.
3. **리서치 기반** -- 하드코딩된 추천이 아닌, 실시간 웹 리서치 기반 근거 제시.
4. **"진짜 제품" 지향** -- 목업/로컬 데모가 아닌 실제 배포 가능한 수준의 기획.

## 질문 설계 규칙 (모든 AskUserQuestion 호출 시 준수)

| 규칙 | 설명 |
|------|------|
| 설명 필수 | 모든 옵션의 description에 "뭔지 + 장점 + 단점" 포함 |
| 추천 표시 | 가장 적합한 옵션 label에 "(추천)" 붙이고 첫 번째 배치 |
| 비유 사용 | 기술 용어 대신 일상 비유 ("OAuth" -> "소셜 로그인") |
| 복잡도 힌트 | 설명에 난이도 표시 ("간단해요", "좀 복잡해요", "많이 복잡해요") |
| 열린 질문 최소화 | 첫 질문(뭘 만들고 싶어?) 하나만 열린 질문, 나머지 전부 선택형 |
| 기타 옵션 불필요 | AskUserQuestion이 자동으로 "Other" 제공 |

상세 인터뷰 방법론: `${CLAUDE_PLUGIN_ROOT}/skills/show-me-the-prd/references/interview-guide.md`

---

## WHEN TRIGGERED - EXECUTE IMMEDIATELY

**DO NOT just display this documentation. EXECUTE the workflow immediately.**

---

## Phase 0: 사전 확인 (자동)

플러그인 의존성을 확인한다. 없어도 동작하지만, 있으면 리서치 품질이 올라간다.

사용 가능한 스킬 목록에 `docs-guide`, `deep-research`가 있는지 확인한다.
있으면 리서치 시 Skill 도구로 호출하고, 없거나 실패하면 WebSearch로 폴백한다.

확인 결과를 내부적으로 기억한다 (유저에게 묻지 않음):
- docs-guide 있음 -> 기술 문서 조사에 Skill(skill="docs-guide", args="...") 활용
- deep-research 있음 -> 종합 리서치에 Skill(skill="deep-research", args="...") 활용
- 둘 다 없음 -> WebSearch로 폴백 (기본 동작에 문제 없음)

---

## 7-Step Workflow

### Step 1: 아이디어 탐색

유저의 한 문장 아이디어에서 핵심 정보를 파악한다.

**1차 AskUserQuestion 호출** (최대 4개 질문 묶기):

```
Q1. "어떤 문제를 해결하는 앱/서비스인가요?"
    -> 유저 자유 입력 (열린 질문 OK -- 유저가 아는 영역)
    -> 이미 $ARGUMENTS에 아이디어가 있으면 이 질문 스킵

Q2. "이 앱을 누가 쓸 건가요?" (header: "사용자")
    options:
    - "나만 쓸 거예요 (추천)" -- 가장 간단, 빠르게 완성 가능. 다만 나중에 다른 사람이 쓰려면 수정 필요.
    - "주변 사람들도 쓸 거예요" -- 여러 사람 의견 반영 가능. 로그인, 권한 관리 추가로 좀 더 복잡.
    - "불특정 다수에게 공개할 거예요" -- 사업/포트폴리오 활용 가능. 보안, 성능, 개인정보보호 등 신경 쓸 게 많아 시간 오래 걸림.

Q3. "비슷한 앱을 써본 적 있나요?" (header: "경험")
    options:
    - "있어요 -- 불만이 있었어요" -- 어떤 앱인지, 뭐가 불편했는지 알려주세요
    - "있어요 -- 괜찮았지만 부족했어요" -- 어떤 부분이 아쉬웠는지 알려주세요
    - "없어요 / 잘 모르겠어요" -- 제가 비슷한 서비스를 조사해볼게요

Q4. "웹앱이에요, 모바일앱이에요?" (header: "플랫폼")
    options:
    - "웹사이트 (추천)" -- 브라우저에서 쓰는 앱. 가장 빠르게 만들 수 있고 누구나 접근 가능. 앱스토어 등록 불필요.
    - "모바일 앱" -- 스마트폰 전용 앱. 카메라, GPS 등 기기 기능 활용 가능. 앱스토어 등록 필요해서 시간/비용 추가.
    - "둘 다" -- 웹 + 모바일. 가장 많은 사람이 쓸 수 있지만, 만드는 시간이 2배 가까이.
    - "잘 모르겠어요" -- 추천대로 웹사이트로 시작할게요
```

**Step 1 완료 후**: 아이디어 요약을 유저에게 보여주고 맞는지 간단히 확인.

---

### [Research Batch 1] 아이디어 직후 리서치

유저가 Step 1에 답변한 직후, 다음 질문을 준비하면서 병렬로 실행:

```
WebSearch: "{도메인} app features 2026"
WebSearch: "{유사 서비스명} 불만 사항 대안"
WebSearch: "{도메인} 앱 필수 기능"
```

리서치 결과를 Step 2의 기능 목록 선택지에 반영한다.

리서치 도구 선택 전략: `${CLAUDE_PLUGIN_ROOT}/skills/show-me-the-prd/references/research-strategy.md`

---

### Step 2: 기능 정리 + 복잡도 안내

리서치 결과를 바탕으로 유저에게 기능 목록을 제시한다.

**먼저 텍스트로 기능 목록 + 복잡도를 안내**:

```
"비슷한 앱들을 조사해봤어요. 이런 기능들이 일반적이에요:

 1. [기능A] -- 간단해요
    [한 줄 설명. 대부분의 프레임워크에서 바로 구현 가능.]

 2. [기능B] -- 좀 복잡해요
    [한 줄 설명. 외부 서비스 연동 필요, 비용 발생 가능.]

 3. [기능C] -- 많이 복잡해요
    [한 줄 설명. 첫 버전에서는 빼고 나중에 추가하는 걸 추천.]"
```

**2차 AskUserQuestion 호출**:

```
Q1. "이 중에 꼭 필요한 기능은 뭐예요?" (header: "핵심 기능", multiSelect: true)
    -> 리서치 기반 기능 목록을 옵션으로 제시
    -> 각 옵션 description에 복잡도 + 설명

Q2. "첫 번째 버전에 넣을 핵심 기능을 골라주세요" (header: "MVP")
    -> Q1 선택 기반으로 조합 제시
    -> "(추천)" 옵션: 가장 간단한 핵심 조합
    -> 각 조합의 예상 복잡도 설명
    -> "잘 모르겠어요 -> 추천대로 갈게요" 옵션 포함
```

---

### [Research Batch 2] 기능 선택 직후

유저가 기능을 선택한 직후, AI가 데이터 모델과 Phase를 자동 생성하는 동안 병렬로:

```
WebSearch/docs-guide: "{선택된 핵심 기능} implementation best practice"
WebSearch: "{도메인} data model design"
```

---

### Step 3: 데이터 모델 확인

AI가 선택된 기능에서 핵심 데이터를 자동 추출하여 설명한다.

**텍스트로 데이터 구조 설명**:

```
"이 앱에서 다루는 핵심 데이터는 N가지예요:

 [엔티티1] -- [일상 용어 설명]
    └── [엔티티2] -- [일상 용어 설명]
           └── [엔티티3] -- [일상 용어 설명]

 이 구조가 중요한 이유: 나중에 기능을 추가할 때
 이 뼈대가 잘 잡혀있으면 쉽고, 안 잡혀있으면 처음부터 다시 해야 해요."
```

**3차 AskUserQuestion 호출**:

```
Q1. "데이터 구조 이렇게 잡았는데 맞아요?" (header: "데이터")
    options:
    - "좋아요, 이대로 갈게요 (추천)" -- 일반적인 구조라 확장하기 좋아요
    - "수정할 부분이 있어요" -- 어떤 부분을 바꾸고 싶은지 알려주세요
    - "잘 모르겠어요" -- 추천대로 갈게요

Q2. "[도메인에 맞는 추가 데이터 질문]" (header: "추가 정보")
    -> 도메인에 따라 동적 생성
    -> 예: 사진앱이면 "사진에 어떤 정보를 같이 저장할까요?" (날짜/위치/태그)
```

---

### Step 4: Phase 분리 확인

AI가 기능 복잡도와 의존성을 기반으로 자동 Phase 분리 후 설명한다.

**텍스트로 Phase 설명**:

```
"한 번에 다 만들면 복잡해져서 품질이 떨어져요.
 이렇게 나눠서 하나씩 완성하는 걸 추천해요:

 Phase 1 (MVP) -- [핵심 기능]
 이것만으로도 실제로 쓸 수 있는 앱이 돼요.
 장점: 빠르게 결과물 확인 / 단점: 아직 [부가 기능] 없음

 Phase 2 -- [확장 기능]
 Phase 1이 안정적으로 돌아간 후에 추가.
 장점: [설명] / 단점: Phase 1 완성 필수

 Phase 3 -- [고도화]
 고급 기능. 없어도 앱은 충분히 쓸 만함.
 장점: [설명] / 단점: 비용/복잡도 높음

 * 각 Phase 완료 기준: 실제 서버에 배포 + 실제 데이터 + 실제 로그인"
```

**4차 AskUserQuestion 호출**:

```
Q1. "이 Phase 분리가 괜찮아요?" (header: "Phase")
    options:
    - "좋아요, 이대로 갈게요 (추천)" -- 보편적인 순서예요
    - "순서를 바꾸고 싶어요" -- 어떤 기능을 먼저 만들고 싶은지 알려주세요
    - "Phase를 합치거나 나누고 싶어요" -- 어떻게 바꾸고 싶은지 알려주세요
```

---

### [Research Batch 3] 기술 스택 선택 전

Phase 확인 후, 기술 스택 질문 전에 리서치:

```
WebSearch: "best tech stack for {플랫폼} {도메인} app 2026"
WebSearch: "{후보 프레임워크1} vs {후보 프레임워크2} 2026 comparison"
docs-guide (있으면): "{후보 프레임워크} getting started"
WebSearch: "{도메인} app deployment cost free tier 2026"
```

---

### Step 5: 기술 스택 선택

리서치 기반으로 프로젝트에 맞는 기술 스택 2-3개를 추천한다.

**5차 AskUserQuestion 호출**:

```
Q1. "코드를 만들 때 어떤 도구를 쓸지 정해야 해요" (header: "기술 스택")
    -> 리서치 기반 2-3개 선택지
    -> 각 옵션 description에 반드시 포함:
       - 무료 시작 가능 여부
       - AI 코딩 호환성 (Claude가 잘 다루는지)
       - 커뮤니티 크기 (문제 해결 난이도)
       - 배포 난이도
       - 확장성

Q2. "로그인 방식을 골라주세요" (header: "인증")
    -> 유저 규모에 따라 옵션 조정
    options 예:
    - "소셜 로그인 (추천)" -- 구글/카카오로 로그인. 비밀번호 관리 불필요. 구글/카카오에 의존.
    - "이메일+비밀번호" -- 전통적. 자유도 높지만, 비밀번호 찾기/변경 기능도 만들어야 해서 시간 더 걸림.
    - "매직링크" -- 비밀번호 없이 이메일 링크로 로그인. 간편하지만 매번 이메일 열어야 함.
    - "로그인 필요 없어요" -- 나만 쓰는 앱이면 생략 가능. 가장 간단.
```

---

### [Research Batch 4] 문서 생성 전 마지막 보강

```
docs-guide (있으면): 선택된 스택의 프로젝트 구조 참고
WebSearch: "{선택된 스택} project structure best practice 2026"
WebSearch: "{선택된 스택} deployment guide"
```

---

### Step 6: 문서 생성

수집된 모든 정보를 종합하여 4종 문서를 생성한다.

출력 디렉토리: 현재 프로젝트 루트에 `PRD/` 폴더 생성.

```
PRD/
├── 01_PRD.md                    # Product Requirements Document
├── 02_DATA_MODEL.md             # 데이터 모델 (개념적 ERD)
├── 03_PHASES.md                 # Phase 분리 계획
├── 04_PROJECT_SPEC.md           # 프로젝트 스펙 (AI 행동 규칙)
└── README.md                    # 네비게이션 가이드
```

각 문서의 템플릿과 섹션 구조: `${CLAUDE_PLUGIN_ROOT}/skills/show-me-the-prd/references/document-templates.md`

**문서 생성 시 규칙**:
- 모든 기술 선택에 "왜 이걸 골랐는지" 근거 포함 (리서치 결과 인용)
- [NEEDS CLARIFICATION] 표시: 아직 정해지지 않은 부분 명시
- Phase별 "진짜 제품" 체크리스트 포함
- 프로젝트 스펙에 "절대 하지 마" 목록 반드시 포함

---

### Step 7: 완료 + 다음 단계 안내

문서 생성 완료 후 유저에게 안내:

1. **품질 요약**: "완성도: X/10" + 개선 포인트 3가지
2. **문서 위치**: `PRD/` 폴더 내 4종 문서 안내
3. **다음 단계 가이드**:

```
"문서가 완성됐어요! 다음 단계를 골라주세요:

 1. Phase 1 바로 시작하기
    이 PRD를 기반으로 Phase 1 개발을 시작해요.
    아래 프롬프트를 Claude Code에 붙여넣으세요:
    [Phase 1 시작 프롬프트 예시 제공]

 2. SDD 도구로 넘기기
    Spec Kit이나 Deep Trilogy 같은 도구에 이 PRD를 넘겨서
    더 상세한 구현 계획을 만들 수 있어요.

 3. 문서 수정하기
    특정 부분을 바꾸고 싶으면 말해주세요."
```

---

## Enhancement Mode (기존 기획 보강)

유저가 기존 기획 문서를 공유한 경우:

1. 문서를 Read로 읽기
2. 4종 문서 기준으로 갭 분석 (빠진 섹션, 모호한 부분 식별)
3. [NEEDS CLARIFICATION] 항목 목록 생성
4. 부족한 부분만 인터뷰 (Step 2-5 중 필요한 부분만)
5. 보강된 4종 문서 생성

---

## References

Refer to `${CLAUDE_PLUGIN_ROOT}/skills/show-me-the-prd/references/` for detailed documentation:

| Reference | Purpose |
|-----------|---------|
| `interview-guide.md` | 인터뷰 방법론, 질문 설계 규칙, 바이브코더 대응 전략 |
| `document-templates.md` | 4종 문서 템플릿과 섹션 구조 |
| `research-strategy.md` | 리서치 오케스트레이션, 도구 라우팅, 배치 전략 |
