@kood/claude-code 0.2.5 → 0.3.0

package/templates/.claude/commands/prd.md

@@ -1,330 +1,613 @@
 ---
-description: PRD(Product Requirements Document) 생성. 기능/제품 정의 시 사용. ultrathink + sequential thinking 3-5 필수.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash(ls:*, mkdir:*), Task, mcp__sequential-thinking__sequentialthinking
-argument-hint: <기능명 또는 제품명>
+description: PRD(Product Requirements Document) 생성
+allowed-tools: Read, Write, Glob, Grep, Task, mcp__sequential-thinking__sequentialthinking
+argument-hint: <기능/제품 설명>
 ---
 
-# PRD Generator
+@../instructions/sequential-thinking-guide.md
 
-AI-friendly PRD(Product Requirements Document)를 생성.
+# PRD Command
 
-## CRITICAL: 필수 요구사항
+기능/제품의 요구사항 문서(PRD)를 작성.
 
-| 요구사항 | 설명 |
-|----------|------|
-| **ARGUMENT 필수** | PRD 대상 없이 실행 시 되물음 |
-| **Ultrathink** | 깊은 사고로 요구사항 분석 |
-| **Sequential Thinking 3-5** | 복잡도에 따라 조정 |
-| **정보 수집 필수** | 사용자에게 필수 정보 질문 |
+**대상**: $ARGUMENTS
 
-## ARGUMENT 확인
+---
+
+<workflow>
+
+## 실행 흐름
+
+| 단계 | 작업 | 도구 |
+|------|------|------|
+| 1. 입력 확인 | ARGUMENT 검증, 없으면 질문 | - |
+| 2. Sequential Thinking | 3-5단계로 PRD 구조 분석 | sequentialthinking |
+| 3. 코드베이스 확인 | 관련 코드/문서 탐색 (필요시) | Task (Explore) |
+| 4. PRD 작성 | 15개 섹션 구조로 작성 | Write |
+| 5. 저장 | `.claude/plans/` 또는 `docs/prd/` | - |
+
+</workflow>
+
+---
+
+<forbidden>
+
+| 분류 | 금지 |
+|------|------|
+| **문제 정의** | 솔루션/기능 목록 포함 |
+| **범위** | In/Out 구분 없이 나열 |
+| **표현** | 모호한 표현 ("좋은 UX", "빠르게") |
+| **스타일** | 마케팅 문구, 과도한 수식어 |
+
+</forbidden>
+
+---
 
+<required>
+
+| 분류 | 필수 |
+|------|------|
+| **구조** | 15개 섹션 (메타데이터~템플릿) |
+| **기능 요구사항** | User Stories + Functional + Non-functional |
+| **지표** | 현재값 → 목표값 형태 |
+| **가정/리스크** | 별도 섹션으로 명시 |
+| **스타일** | 짧고 명확한 문장, 구체적 예시 |
+
+</required>
+
+---
+
+<prd_structure>
+
+## PRD 15개 섹션 구조
+
+### 1. 메타데이터
+
+| 항목 | 내용 |
+|------|------|
+| **제목** | 제품명 + 버전/설명 |
+| **작성자** | PM/오너 |
+| **버전** | v0.1 (초안), v1.0 (확정) 등 |
+| **날짜** | 최초 작성일, 마지막 수정일 |
+| **관련 문서** | 전략 문서, 디자인, 기술 설계 링크 |
+
+### 2. 비전 & 배경
+
+```text
+✅ 3-5문장 이내
+✅ "어떤 사용자, 어떤 문제, 어떤 임팩트"
+
+포함 내용:
+- 제품 비전 (1-2문장)
+- 배경/컨텍스트 (왜 지금 하는지)
+- 이전 시도/기존 제품 한계 (간단히)
 ```
-$ARGUMENTS 없음 → 즉시 질문:
-"어떤 제품/기능의 PRD를 작성할까요?
 
-예시:
-- 신규 기능: '사용자 알림 시스템'
-- 제품: '관리자 대시보드'
-- 개선: '결제 프로세스 개선'"
+### 3. 문제 정의 & 목표
+
+| 섹션 | 내용 | 포함 요소 |
+|------|------|----------|
+| **문제 정의** | 어떤 문제/기회가 있는지 | 유저 피드백, 지표 (전환율, 이탈률) |
+| **목표** | 비즈니스/사용자 목표 | 측정 가능한 KPI (예: 결제율 +5%) |
 
-$ARGUMENTS 있음 → 다음 단계 진행
+```text
+❌ 솔루션/기능 목록 넣지 않기
+✅ "무엇이 문제이고 무엇을 달성하려 하는지"만
 ```
 
-**PRD 대상**: $ARGUMENTS
+### 4. 범위 (Scope)
 
-## 실행 흐름
+| 구분 | 내용 |
+|------|------|
+| **In Scope** | 이번 릴리즈 포함 기능 (P0/P1 표시) |
+| **Out of Scope** | 하지 않는 것 (후속 릴리즈 메모) |
+
+### 5. 타깃 유저 & 페르소나
 
+```markdown
+## 주요 타깃 유저
+- 세그먼트 1
+- 세그먼트 2
+
+## 페르소나 (1-3개)
+**이름(가명)**:
+**역할**:
+**목표**:
+**Pain Point**:
+
+**Primary Persona**: [가장 우선 해결]
 ```
-1. ARGUMENT 확인 (없으면 되물음)
-2. Sequential Thinking으로 정보 수집 계획 (1단계)
-3. 필수 정보 순차 질문 (2-3단계)
-4. 선택 정보 확인 (4단계)
-5. PRD 문서 생성 (5단계)
-6. .claude/prd/[기능명].md 저장
+
+```text
+✅ 행동/맥락/목표 중심
+❌ 기능 설명 아님
 ```
 
-## 정보 수집 (대화형)
+### 6. 사용자 여정 & 시나리오
 
-### 필수 질문 (순차 진행)
+```markdown
+## 주요 여정 단계
+랜딩 → 가입 → 첫 세팅 → 핵심 기능 → 반복 → 업그레이드
 
-**Q1. 개요**
-```
-[제품/기능명]에 대해 알려주세요:
+## 이번 PRD 구간
+[해당 구간 표시]
 
-1. 무엇을 만드나요? (1-2문장)
-2. 왜 필요한가요? (배경/문제)
+## 대표 시나리오
+사용자 A는 X를 하기 위해 앱을 연다.
+...
+그래서 Y를 할 수 있게 된다.
 ```
 
-**Q2. 사용자**
+```text
+✅ 사용자 목적과 단계만 요약
+❌ 상세한 UI 단계 나열 금지
 ```
-누구를 위한 것인가요?
 
-1. 주 사용자 그룹
-2. 사용자가 겪는 문제점
+### 7. 기능 요구사항 (핵심)
+
+#### 기능 구조
+
+각 기능마다 포함:
+
+| 필드 | 내용 |
+|------|------|
+| **기능 이름** | - |
+| **설명** | 1-2문장 |
+| **목표/가치** | 어떤 문제 해결, 어떤 지표 영향 |
+| **우선순위** | P0/P1 또는 Must/Should/Could |
+| **관련 시나리오** | 사용자 시나리오/페르소나 |
+
+#### 기능 상세
+
+```markdown
+### [기능 1]
+
+#### User Stories
+- As a [유저 타입], I want to [행동] so that [가치]
+- ...
+
+#### 기능 설명
+동작, 상태, 변형 설명.
+- Happy Path
+- Alternative Flow
+- Edge Case
+
+#### Functional Requirements
+- 시스템은 X 버튼 클릭 시 Y API 호출해야 함
+- 성공 시 Z 화면 이동해야 함
+
+#### Non-functional Requirements
+- 퍼포먼스: 응답 시간 < 200ms
+- 보안: JWT 인증 필수
+- 사용성: 키보드 네비게이션 지원
 ```
 
-**Q3. 기능**
+### 8. UX/UI 요구사항
+
+| 항목 | 내용 |
+|------|------|
+| **핵심 원칙** | "간편함 우선", "모바일 우선" 등 |
+| **UI 제약** | 필수 정보, 숨기면 안 되는 액션 |
+| **접근성** | 다국어, 키보드, 대비, 폰트 제한 |
+
+```text
+✅ 디자인이 꼭 지켜야 하는 제약/원칙
+❌ 상세 디자인 아님
 ```
-어떤 기능이 필요한가요?
 
-1. 반드시 필요한 기능 (Must Have)
-2. 있으면 좋은 기능 (Nice to Have)
-3. 제외할 것 (Out of Scope)
+### 9. 기술/데이터 요구사항
+
+| 항목 | 내용 |
+|------|------|
+| **기술 제약** | 스택, 호환성, 아키텍처 연결 |
+| **통합/의존성** | 외부 서비스 API, 내부 시스템 |
+| **데이터** | 저장/조회/집계 데이터, 엔티티 |
+| **보안/규제** | 인증/인가, 개인정보, 감사 로그 |
+
+```text
+✅ 개발 설계 시작 전 꼭 알아야 할 제약
+❌ 구현 세부 코드 수준 금지
 ```
 
-**Q4. 성공 지표**
+### 10. 성공 지표 & KPI
+
+```markdown
+| 지표 | 현재값 | 목표값 | 측정 방법 |
+|------|--------|--------|----------|
+| 활성 사용자 | 1,000 | 1,500 | GA 이벤트 |
+| 전환율 | 20% | 25% | 결제 완료 / 방문 |
+| 이탈률 | 40% | 25% 이하 | 가입 플로우 |
 ```
-성공을 어떻게 측정하나요?
 
-예시:
-- 사용자 만족도 80% 이상
-- 처리 시간 50% 감소
-- 일일 활성 사용자 1000명
+```text
+✅ 현재값 → 목표값 형태
+✅ 측정 방법 명시
 ```
 
-### 선택 질문 (해당 시만)
+### 11. 리스크, 가정, 의존성
+
+| 분류 | 내용 |
+|------|------|
+| **가정** | "유저는 이메일 인증 완료 상태", "마케팅 캠페인 진행" |
+| **리스크** | 기술/비즈니스/UX 리스크, 심각도/가능성 |
+| **의존성** | 다른 팀/프로젝트/벤더, 선행 작업 |
 
+```text
+✅ 별도 섹션으로 명확히
+❌ 기능 설명에 섞지 않기
 ```
-추가 정보가 있나요?
 
-- 기술 제약: 사용해야 하는 기술 스택
-- 일정: 목표 출시일
-- 참조 문서: 디자인/기획 문서
-- AI 사용: AI/ML 기능 포함 여부
+### 12. 릴리즈 전략 & 마일스톤
 
-없으면 'N'을 입력하세요.
+```markdown
+## 릴리즈 전략
+- 전체 론칭 / 단계적 롤아웃 / A/B 테스트
+
+## 마일스톤
+- 설계 완료: 2025-02-15
+- 개발 완료: 2025-03-01
+- 베타 릴리즈: 2025-03-15
+- GA: 2025-04-01
+
+## 롤백 계획
+- Feature Flag 사용
+- 문제 발생 시 즉시 비활성화
 ```
 
-## Sequential Thinking 가이드
-
+```text
+✅ 타임라인 + 큰 이벤트만
+❌ 상세 스프린트 계획 금지
 ```
-thought 1: PRD 범위 및 복잡도 판단
-thought 2: 핵심 요구사항 정리 (사용자 입력 기반)
-thought 3: 기능 상세화 및 우선순위 결정
-thought 4: 기술 요구사항 및 제약 정리
-thought 5: PRD 문서 구조화 및 작성
+
+### 13. 오픈 이슈 & Todo
+
+```markdown
+## Open Questions
+
+| 질문 | 결정자 | 기한 |
+|------|--------|------|
+| 가격 정책 | PM | 2025-02-10 |
+| 온보딩 플로우 구성 | UX팀 | 2025-02-15 |
+| 정책 문구 확정 | Legal | 2025-02-20 |
 ```
 
-## PRD 템플릿
+```text
+✅ 불확실한 부분 명시
+❌ 숨기지 않기
+```
 
-**파일 위치:** `.claude/prd/[기능명].md`
+### 14. 작성 스타일 가이드 (Claude용)
 
-```markdown
-# PRD: [제품/기능명]
+| 원칙 | 적용 |
+|------|------|
+| **톤** | 짧고 명확한 문장, 수식어 제거 |
+| **구조** | 1-13 섹션 순서 유지 |
+| **구체성** | "좋은 UX" → 구체적 기준/예시 |
+| **트레이드오프** | 선택 이유 한 줄 설명 |
+
+### 15. Claude 최종 지시
+
+```text
+1. 15개 섹션 구조 기준으로 PRD 구성
+2. 입력(아이디어, 회의 메모)을 다음으로 재구성:
+   - 문제/목표
+   - 범위
+   - 기능 요구사항
+   - 리스크/가정
+   - 성공 지표
+
+3. 기능/요구사항 작성 시 포함:
+   - User Stories
+   - 기능 설명
+   - Functional Requirements
+   - Non-functional Requirements
+
+4. 불명확한 부분:
+   - "Open Questions" 섹션에 질문 리스트
+
+5. 기존 PRD 수정 시:
+   - Change log (변경 요약)
+```
 
-**상태**: Draft
-**작성일**: [YYYY-MM-DD]
-**버전**: 1.0
+</prd_structure>
 
 ---
 
-## 1. 개요
+<template>
 
-### 1.1 배경
-[왜 이 제품/기능이 필요한가?]
+## PRD 템플릿
+
+```markdown
+# [제품/기능명] PRD
 
-### 1.2 목표
-[이 제품/기능이 달성하고자 하는 것]
+## 메타데이터
 
-### 1.3 성공 지표
-| 지표 | 목표값 | 측정 방법 |
-|------|--------|----------|
-| [지표1] | [목표] | [방법] |
+| 항목 | 내용 |
+|------|------|
+| **작성자** | [이름] |
+| **버전** | v0.1 |
+| **작성일** | YYYY-MM-DD |
+| **수정일** | YYYY-MM-DD |
+| **관련 문서** | [링크] |
 
 ---
 
-## 2. 사용자 정의
+## 1. 비전 & 배경
 
-### 2.1 목표 사용자
-| 페르소나 | 특성 | 주요 니즈 |
-|----------|------|----------|
-| [페르소나1] | [특성] | [니즈] |
+**비전**: [1-2문장]
 
-### 2.2 사용자 문제
-| 문제 | 빈도 | 심각도 |
-|------|------|--------|
-| [문제1] | High/Med/Low | High/Med/Low |
+**배경**: [왜 지금 하는지]
 
-### 2.3 사용자 스토리
-```
-As a [사용자],
-I want to [행동],
-So that [가치/결과].
-```
+**기존 한계**: [간단히]
 
 ---
 
-## 3. 기능 정의
+## 2. 문제 정의 & 목표
 
-### 3.1 핵심 기능 (P0 - Must Have)
-| 기능 | 설명 | 수락 기준 |
-|------|------|----------|
-| [기능1] | [설명] | [기준] |
+### 문제
+[어떤 문제/기회]
 
-### 3.2 부가 기능 (P1 - Nice to Have)
-| 기능 | 설명 | 수락 기준 |
-|------|------|----------|
-| [기능2] | [설명] | [기준] |
+**인사이트**:
+- 유저 피드백: [요약]
+- 지표: 전환율 15%, 이탈률 50%
 
-### 3.3 범위 외 (Out of Scope)
-- [제외 항목1]
+### 목표
+
+| 분류 | 목표 |
+|------|------|
+| **비즈니스** | 결제 완료율 +5% |
+| **사용자** | 작업 시간 30% 단축 |
 
 ---
 
-## 4. 상세 기능
+## 3. 범위
 
-### 4.1 [기능명]
+### In Scope (P0/P1)
+- [ ] 기능 1 (P0)
+- [ ] 기능 2 (P1)
 
-**설명**: [기능 설명]
+### Out of Scope
+- 기능 X (후속 릴리즈)
 
-**사용자 플로우**:
-1. 사용자가 [행동1]
-2. 시스템이 [응답1]
+---
 
-**입력/출력**:
-| 입력 | 타입 | 필수 | 설명 |
-|------|------|------|------|
-| [입력1] | string | Y | [설명] |
+## 4. 타깃 유저 & 페르소나
 
-| 출력 | 타입 | 설명 |
-|------|------|------|
-| [출력1] | object | [설명] |
+### 주요 세그먼트
+- 세그먼트 1
+- 세그먼트 2
+
+### 페르소나
 
-**엣지 케이스**:
-| 케이스 | 처리 |
-|--------|------|
-| [케이스1] | [처리 방법] |
+**이름**: 김OO
+**역할**: 소규모 쇼핑몰 운영자
+**목표**: 재고 관리 자동화
+**Pain Point**: 수동 입력 시간 과다
+
+**Primary Persona**: 김OO
 
 ---
 
-## 5. 기술 요구사항
+## 5. 사용자 여정 & 시나리오
 
-### 5.1 기술 스택
-| 영역 | 기술 | 버전 |
-|------|------|------|
-| Frontend | [기술] | [버전] |
-| Backend | [기술] | [버전] |
-
-### 5.2 비기능 요구사항
-| 항목 | 요구사항 |
-|------|----------|
-| 성능 | [예: 응답시간 < 500ms] |
-| 확장성 | [예: 동시접속 10K] |
-| 보안 | [예: HTTPS 필수] |
-
-### 5.3 AI 요구사항 (해당 시)
-| 항목 | 요구사항 |
-|------|----------|
-| 모델 | [사용 모델] |
-| 정확도 | [목표 정확도] |
-| 가드레일 | [안전장치] |
+### 여정 단계
+`랜딩 → [가입 → 첫 세팅] → 핵심 기능 → 반복 → 업그레이드`
+
+### 대표 시나리오
+사용자는 재고를 빠르게 등록하기 위해 앱을 연다.
+...
+5분 안에 100개 상품을 등록할 수 있다.
 
 ---
 
-## 6. 일정
+## 6. 기능 요구사항
+
+### 기능 1: [이름]
+
+**설명**: [1-2문장]
 
-| 마일스톤 | 목표일 | 산출물 |
-|----------|--------|--------|
-| MVP | [날짜] | [산출물] |
-| Beta | [날짜] | [산출물] |
-| GA | [날짜] | [산출물] |
+**목표**: [어떤 문제 해결]
+
+**우선순위**: P0
+
+#### User Stories
+- As a 쇼핑몰 운영자, I want to 엑셀로 재고를 일괄 등록 so that 시간을 절약할 수 있다
+
+#### 기능 설명
+- 엑셀 파일 업로드 (최대 1,000행)
+- 검증: 필수 필드, 중복 체크
+- 성공/실패 피드백
+
+#### Functional Requirements
+- 시스템은 엑셀 업로드 시 필수 필드(상품명, 가격) 검증해야 함
+- 중복 상품은 경고 표시 후 사용자 선택(덮어쓰기/건너뛰기)
+- 성공 시 재고 목록 페이지로 이동
+
+#### Non-functional Requirements
+- 성능: 1,000행 처리 < 3초
+- 보안: 파일 크기 제한 5MB
+- 사용성: 진행률 표시
 
 ---
 
-## 7. 위험 및 의존성
+### 기능 2: [이름]
+...
 
-### 7.1 위험 요소
-| 위험 | 영향 | 대응 방안 |
-|------|------|----------|
-| [위험1] | High/Med/Low | [대응] |
+---
 
-### 7.2 의존성
-| 항목 | 담당 | 상태 |
-|------|------|------|
-| [의존1] | [담당] | [상태] |
+## 7. UX/UI 요구사항
+
+| 항목 | 내용 |
+|------|------|
+| **핵심 원칙** | 간편함 우선, 3클릭 이내 완료 |
+| **필수 정보** | 진행률 바, 에러 메시지 |
+| **접근성** | 키보드 네비게이션, 한/영 지원 |
+
+---
+
+## 8. 기술/데이터 요구사항
+
+| 항목 | 내용 |
+|------|------|
+| **기술 스택** | React, TanStack Query, Prisma |
+| **통합** | Excel Parser (xlsx.js) |
+| **데이터** | Product 테이블 (name, price, quantity) |
+| **보안** | JWT 인증, File validation |
 
 ---
 
-## 8. 오픈 이슈
+## 9. 성공 지표 & KPI
 
-| # | 이슈 | 담당 | 상태 |
-|---|------|------|------|
-| 1 | [이슈1] | [담당] | Open |
+| 지표 | 현재값 | 목표값 | 측정 방법 |
+|------|--------|--------|----------|
+| 등록 시간 | 평균 15분 | 5분 이하 | 업로드 완료 이벤트 |
+| 에러율 | 30% | 10% 이하 | 실패 업로드 / 전체 |
+| 주간 활성 | 500명 | 800명 | GA 이벤트 |
 
 ---
 
-## 부록
+## 10. 리스크, 가정, 의존성
 
-### A. 용어 정의
-| 용어 | 정의 |
+| 분류 | 내용 |
 |------|------|
-| [용어1] | [정의] |
+| **가정** | 사용자는 엑셀 형식을 알고 있음 |
+| **리스크** | 대용량 파일 처리 성능 (완화: 행 수 제한) |
+| **의존성** | xlsx.js 라이브러리 |
 
-### B. 변경 이력
-| 버전 | 날짜 | 변경 내용 |
-|------|------|----------|
-| 1.0 | [날짜] | 초안 작성 |
+---
+
+## 11. 릴리즈 전략
+
+**전략**: 단계적 롤아웃 (베타 → GA)
+
+**마일스톤**:
+- 설계 완료: 2025-02-20
+- 베타 릴리즈: 2025-03-10 (100명)
+- GA: 2025-03-25
+
+**롤백**: Feature Flag 사용
+
+---
+
+## 12. 오픈 이슈
+
+| 질문 | 결정자 | 기한 |
+|------|--------|------|
+| 엑셀 템플릿 제공 여부 | PM | 2025-02-15 |
+| 에러 메시지 문구 확정 | UX | 2025-02-20 |
 ```
 
-## Claude Code 친화적 PRD 특징
+</template>
 
-| 특징 | 설명 |
-|------|------|
-| **테이블 형식** | 정보 구조화로 빠른 파악 |
-| **명확한 입출력** | 기능별 입력/출력 명시 |
-| **우선순위** | P0/P1/P2로 구현 순서 명확 |
-| **엣지 케이스** | 예외 상황 사전 정의 |
-| **수락 기준** | 구현 완료 기준 명확화 |
+---
+
+<examples>
+
+## 실전 예시
 
-## 작성 규칙
+### 예시 1: 사용자 프로필 편집
 
-### DO
-- 구체적인 숫자와 지표 사용
-- 사용자 관점에서 기능 설명
-- 명확한 범위 정의 (In/Out of Scope)
-- 측정 가능한 성공 기준
-- 엣지 케이스 미리 정의
+```bash
+사용자: /prd 사용자 프로필 편집 기능
 
-### DON'T
-- 모호한 표현 ("빠른", "좋은")
-- 기술 구현 세부사항 과도 포함
-- 범위 없이 모든 것 포함
-- 검증 없는 가정
+1. Sequential Thinking (5단계):
+   thought 1: "프로필 편집 - 보통 복잡도, CRUD 기본 기능"
+   thought 2: "현재 User 모델 확인 필요, 인증 방식 파악"
+   thought 3: "편집 가능 필드: 이름, 이메일, 프로필 이미지"
+   thought 4: "검증: 이메일 중복, 이미지 크기, 형식"
+   thought 5: "API: PUT /api/user/:id, 클라이언트: useQuery + useMutation"
 
-## 예시 워크플로우
+2. Task 탐색:
+   Task (Explore): "User 모델 및 인증 구조 분석"
 
+3. PRD 작성:
+   → .claude/plans/profile-edit-prd.md
+
+4. 주요 섹션:
+   - 문제: 사용자가 정보를 수정할 방법이 없음
+   - 목표: 프로필 편집 완료율 90% 이상
+   - 기능: 이름/이메일/이미지 편집, 실시간 검증
+   - KPI: 편집 완료율, 에러율
 ```
-1. 사용자: /prd 사용자 알림 시스템
 
-2. Claude:
-   "사용자 알림 시스템 PRD를 작성하겠습니다.
+### 예시 2: 실시간 알림
+
+```bash
+사용자: /prd 실시간 알림 시스템 추가
+
+1. Sequential Thinking (7단계):
+   thought 1: "실시간 알림 - 복잡도 높음, 새 인프라 필요"
+   thought 2: "현재 통신: REST만, 폴링 없음"
+   thought 3: "제약: 서버 부하, 클라이언트 연결 관리"
+   thought 4: "접근: WebSocket vs SSE vs Firebase"
+   thought 5: "WebSocket - 양방향, 복잡. SSE - 단방향, 간단"
+   thought 6: "옵션 3개: WebSocket(추천), SSE, Firebase"
+   thought 7: "WebSocket 추천 - 확장성, 제어 가능"
+
+2. PRD 작성:
+   - 비전: "사용자가 즉시 중요한 업데이트를 받는다"
+   - 범위:
+     * In: 주문 상태, 메시지 알림
+     * Out: 푸시 알림 (후속)
+   - 기술: WebSocket (ws 라이브러리), Redis Pub/Sub
+   - 리스크: 연결 안정성 (완화: 자동 재연결)
+```
 
-   Q1. 개요
-   1. 무엇을 만드나요?
-   2. 왜 필요한가요?"
+### 예시 3: 대시보드 분석 기능
+
+```bash
+사용자: /prd 대시보드 분석 기능 - 매출, 주문, 트래픽 차트
+
+1. Sequential Thinking (5단계):
+   thought 1: "대시보드 - 보통 복잡도, 데이터 집계 + 시각화"
+   thought 2: "데이터: Order, Payment, Analytics 테이블"
+   thought 3: "차트: 라인(트렌드), 바(비교), 파이(비율)"
+   thought 4: "필터: 기간(일/주/월), 카테고리"
+   thought 5: "성능: 집계 쿼리 최적화, 캐싱 필요"
+
+2. PRD 핵심:
+   - 문제: 매출 데이터를 확인하려면 여러 페이지 접근 필요
+   - 목표: 대시보드 사용률 70% 이상
+   - 기능 요구사항:
+     * User Story: "As a 관리자, I want to 매출 트렌드를 한눈에 보고 싶다"
+     * Functional: 기간별 매출 집계, 차트 렌더링
+     * Non-functional: 쿼리 < 500ms, 캐싱 5분
+   - 성공 지표:
+     * 페이지뷰: 0 → 500/일
+     * 로딩 시간: - → 500ms 이하
+```
 
-3. 사용자: "실시간 알림 기능. 사용자가 중요 이벤트를 놓침."
+</examples>
 
-4. Claude:
-   "Q2. 누구를 위한 것인가요?
-   1. 주 사용자 그룹
-   2. 겪는 문제점"
+---
 
-5. 사용자: "모든 로그인 사용자. 이메일 확인 안 함."
+<validation>
 
-6. (계속 질문...)
+## 검증 체크리스트
 
-7. PRD 생성: .claude/prd/notification-system.md
+실행 전:
+
+```text
+✅ ARGUMENT 확인 (없으면 질문)
+✅ Sequential Thinking 3-5단계
+✅ Task (Explore)로 코드베이스 확인 (필요시)
+✅ 15개 섹션 구조 준수
+✅ User Stories 형식 작성
+✅ Functional/Non-functional 구분
+✅ 현재값 → 목표값 지표
+✅ Open Questions 명시 (불확실한 부분)
 ```
 
-## CRITICAL: 절대 금지
+절대 금지:
+
+```text
+❌ ARGUMENT 없이 PRD 작성
+❌ Sequential Thinking 3단계 미만
+❌ 문제 정의에 솔루션 포함
+❌ In/Out Scope 구분 없이 나열
+❌ 모호한 표현만 사용 ("좋은 UX")
+❌ User Stories 없이 기능만 나열
+❌ 불확실한 부분 숨기기
+```
 
-| 금지 항목 |
-|----------|
-| ARGUMENT 없이 PRD 작성 시작 |
-| 정보 수집 없이 가정으로 작성 |
-| Sequential Thinking 3단계 미만 |
-| 성공 지표 없는 PRD |
-| 기능 우선순위 없는 PRD |
-| 엣지 케이스 고려 없는 기능 정의 |
+</validation>