hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-prd
hyper-prd
Verified[Hyper] Use this skill when the user wants a product requirements document for a web, iOS, Android, or desktop product - a new idea to size and write, an existing PRD to revise, or a PRD to review - and expects one `prd.md` file with goals, metrics, scoped stories, EARS requirements, acceptance scenarios, and a handoff block. It decides platform and size first, asks only the decisions the user alone can make within the size's question budget, marks unknowns inline, and stops at the document. Do not use it for user flows, wireframes, diagrams, HTML previews, technical design, task breakdowns, or implementation.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 23.3 KB |
| SKILL.md | skill md | 21.6 KB |
| assets/evals/hyper-prd-cases.jsonl | other | 12.9 KB |
| references/platforms/android.ko.md | markdown | 11.6 KB |
| references/platforms/android.md | markdown | 11.1 KB |
| references/platforms/desktop.ko.md | markdown | 8.9 KB |
| references/platforms/desktop.md | markdown | 8.6 KB |
| references/platforms/ios.ko.md | markdown | 9.6 KB |
| references/platforms/ios.md | markdown | 9.5 KB |
| references/platforms/web.ko.md | markdown | 10.3 KB |
| references/platforms/web.md | markdown | 10.1 KB |
| references/prd-template.ko.md | markdown | 25.0 KB |
| references/prd-template.md | markdown | 23.3 KB |
| rules/intake-and-questions.ko.md | markdown | 6.9 KB |
| rules/intake-and-questions.md | markdown | 6.7 KB |
| rules/requirements-writing.ko.md | markdown | 10.0 KB |
| rules/requirements-writing.md | markdown | 9.7 KB |
| rules/validation.ko.md | markdown | 8.7 KB |
| rules/validation.md | markdown | 8.2 KB |
references/prd-template.ko.md
View on GitHub# PRD Template
`prd.md`를 새로 만들거나 구조를 바꿀 때 이 참조를 사용한다. 절 순서, 골격, 예시 하나를 소유한다.
## Contents
- Section order
- Skeleton
- Worked example
- Release gate table
- Data collection matrix
- Rules
## Section order
1. 메타: 상태, 플랫폼, 규모, 예산 대비 질문 수, 읽은 출처, 갱신일
2. 한 줄 정의
3. 문제와 근거
4. 대상 사용자와 명시적 제외 대상
5. 목표와 지표
6. 범위: P1/P2/P3 스토리, 비목표, 바뀌면 안 되는 동작
7. 기능 요구사항
8. 인수 시나리오
9. 플랫폼 요구사항: 결정된 플랫폼마다 블록 하나와 그 안의 출시 게이트 표, 그리고 `ios`와 `android`를 함께 대상으로 할 때 한 번만 쓰는 데이터 수집 매트릭스
10. 가정
11. 열린 질문
12. 위험과 의존성
13. 변경 이력
14. 핸드오프 블록
적용되지 않는 절은 지운다. 내용 없이 제목만 두지 않고 `N/A`도 쓰지 않는다.
## Skeleton
```markdown
# <제품 또는 기능 이름> PRD
## Meta
- Status: draft | ready | revised
- Platforms: web | ios | android | desktop (하나 이상) - <판정 이유 한 줄>
- Size: S | M | L - <판정 이유 한 줄>
- Questions: <물은 수>/<예산>
- Sources read: <첫 질문 전에 읽은 저장소 경로, 문서, 붙여 준 맥락>
- Updated: YYYY-MM-DD
## Definition
<한 문장. 무엇이고, 누구를 위한 것이며, 무엇이 달라지는지.>
## Problem and evidence
- 구체적 사례 하나: <누가, 언제, 무엇이 일어났는지, 실제 값과 함께>
- 지금의 대안: <오늘 대신 사람들이 하는 일>
- 근거 등급: observed | reported | assumed
## Target users and exclusions
- 사용자: <이 문서가 구체적으로 섬기는 사람>
- 제외 대상: <이 문서가 일부러 섬기지 않는 사람>
## Goals and metrics
| 목표 | 지표 | 목표치 | 측정 수단 | 측정 시점 |
|---|---|---|---|---|
| <목표> | <주 지표> | <숫자 + 단위> | <수치가 나오는 곳> | <측정 창> |
| <목표> | <보조 지표> | <숫자 + 단위> | <출처> | <측정 창> |
| <목표> | <대응 지표> | <하한 + 단위> | <출처> | <측정 창> |
## Scope
### P1 - <스토리 이름>
- 우선순위 이유: <왜 지금이고, 밀리면 무엇이 깨지는지>
- 독립 테스트: <뒤 스토리 없이 이 스토리만 어떻게 증명하는지>
- 요구사항: FR-001, FR-002
### P2 - <스토리 이름>
- 우선순위 이유: <...>
- 독립 테스트: <...>
- 요구사항: FR-003
### P3 - <스토리 이름>
- 우선순위 이유: <...>
- 독립 테스트: <...>
- 요구사항: FR-004
### 비목표
- <이 문서가 일부러 하지 않는 일과, 했다면 더해졌을 것>
- <범위의 다른 부분을 자르는 두 번째 항목>
### 바뀌면 안 되는 동작
- FR-010 WHEN <기존 조건>, the system SHALL CONTINUE TO <기존 동작>.
## Functional requirements
| Id | 우선순위 | 요구사항 | 검증 |
|---|---|---|---|
| FR-001 | P0 | <EARS 문장> | <검토자가 무엇을 하고 무엇을 보는지> |
| FR-002 | P1 | <EARS 문장> | <...> |
## Acceptance scenarios
### <스토리 이름>
```text
Scenario: <정상 경로 이름> (FR-001, FR-002)
Given <구체적인 시작 상태>
When <행동 하나>
Then <관측 가능한 결과>
Scenario: <실패 또는 경계 이름> (FR-002)
Given <구체적인 시작 상태>
When <행동 하나>
Then <관측 가능한 결과>
```
## Platform requirements
### web
<결정된 플랫폼마다 블록 하나, 판정한 순서대로. 블록을 채운 체크리스트 파일 이름을 적는다. 결정되지 않은 플랫폼은 블록도 없고 그 체크리스트도 읽지 않는다.>
#### Release gate
| ID | 등급 | 항목 | 결론 | 근거 | 재확인 |
|---|---|---|---|---|---|
| W5 | `[M-조건]` | <항목 문장, 짧은 형태> | 해당, 또는 조건과 이유가 붙은 비해당, 또는 `[확인 필요: <질문>]` | <결론을 정하는 문서, 화면, 측정> | <날짜가 붙은 값을 다시 확인하는 날, 없으면 `none`> |
| W6 | `[M-조건]` | <...> | <...> | <...> | <...> |
| W1 | `[G]` | <이 제품에 관련 있을 때만> | <...> | <...> | <...> |
### Data collection matrix (ios and android)
`ios`와 `android`를 함께 대상으로 할 때만, 플랫폼 요구사항 절 안에서 플랫폼 블록 밖에 한 번만 쓴다.
| 데이터 유형 | 수집 | 제3자 공유 | 사용자 신원 연결 | 추적 사용 | 목적 | 선택 여부 | 일시 처리 |
|---|---|---|---|---|---|---|---|
| <예: 이메일 주소> | yes | no | yes | no | 계정 로그인 | no | no |
| <예: 대략적 위치> | no | - | - | - | 수집하지 않음. 두 스토어 서술을 맞추려고 적는다 | - | - |
Apple 프라이버시 라벨 관점: <표의 어느 행이 App Privacy 라벨의 어느 데이터 유형에 대응하고, 라벨이 각각 무엇이라고 적는지>.
Play Data safety 관점: <어느 행이 Data safety의 어느 데이터 유형에 대응하고, 신고가 각각 무엇이라고 적는지. 답이 "수집하는 데이터 없음"일 때도 그렇게 적는다>.
- 매트릭스는 한 번만 쓴다. App Privacy 라벨(`I4`)과 Play Data safety 신고(`A2`, `A3`)가 모두 이 표에서 읽고, 어느 쪽도 데이터 유형을 기억으로 다시 쓰지 않는다.
- 한 플랫폼만 다루고 다른 쪽은 다루지 않는 데이터 유형은 제품 결정이다. 차이와 그 이유를 매트릭스 옆에 적는다.
## Assumptions
- A-001: <진술>
- 근거 등급: repo fact | convention default | guess
- 근거: <경로, 인용, 또는 의지한 관례>
- 틀렸을 때: <무엇이 바뀌는지>
## Open questions
- Q-001: <질문>
- 답할 사람: <역할>
- 막힘: yes | no
- 이력: Q: <질문> → A: <답 또는 unanswered>
## Risks and dependencies
- 위험: <무엇이 실패할 수 있고, 이른 신호는 무엇인지>
- 의존성: <이 문서 밖에서 필요한 것>
## Change history
| 날짜 | 모드 | 바뀐 내용 |
|---|---|---|
| YYYY-MM-DD | create | 최초 문서 |
## Handoff
- 플랫폼: <결정된 플랫폼>
- 규모: <S | M | L>
- P1 범위: <먼저 출시하는 스토리와 요구사항>
- 남은 막힘 질문: <Q ID, 또는 "none">
- 다음 단계 입력: <다음 단계가 이 문서에서 읽는 것>
```
## Worked example
```markdown
# 집중 타이머 PRD
## Meta
- Status: draft
- Platforms: ios, android - 지원 스레드가 휴대폰 타이머를 말하고, 요청이 두 스토어를 지정했다
- Size: S - 단일 목적 신규 앱의 화면 하나와 동작 하나 변경이다
- Questions: 1/1
- Sources read: 문제와 근거에 인용한 지원 스레드. 저장소 문서는 없음(신규 제품)
- Updated: 2026-11-07
## Definition
고정된 세션을 시작하고 세션 중 설정 변경을 막는 단일 목적 집중 타이머다. 타이머 설정이 너무 많아 흐름을 놓치는 사람을 위한 것이다.
## Problem and evidence
- 구체적 사례 하나: 2026-10-28 지원 스레드에서 한 사용자가 25분 세션을 네 번 다시 시작했다. 설정 화면이 세션 중에 여섯 가지 길이 프리셋을 제공했기 때문이다.
- 지금의 대안: 일반 타이머 앱에 의도한 길이를 종이에 적어 두는 것.
- 근거 등급: reported
## Target users and exclusions
- 사용자: 하루에 짧은 집중 블록을 여러 번 도는 개인 지식 노동자
- 제외 대상: 공유 세션 대시보드가 필요한 팀, 간격 반복이나 뽀모도로 연쇄가 필요한 사람
## Goals and metrics
| 목표 | 지표 | 목표치 | 측정 수단 | 측정 시점 |
|---|---|---|---|---|
| 세션이 끝까지 진행된다 | 완료 세션 비율 | 시작한 세션의 70% 이상 | 세션 시작·종료 이벤트 | 출시 후 첫 14일 |
| 세션이 빠르게 시작된다 | 앱 열기부터 세션 시작까지의 중앙값 | 5초 이하 | 시작 시각 이벤트 쌍 | 출시 후 첫 14일 |
| 이 블록이 나머지 앱을 해치지 않는다 | 크래시 없는 세션 비율 | 99.5% 이상(대응 지표 하한) | 세션당 크래시 보고 | 출시 후 첫 30일 |
## Scope
### P1 - 세션 하나를 시작하고 끝낸다
- 우선순위 이유: 끝까지 가는 경로가 없으면 제품이 없고, 다른 무엇도 측정할 수 없다.
- 독립 테스트: 25분 세션을 시작하고 앱을 백그라운드로 보낸 뒤 25분 후 돌아와 완료 상태를 본다.
- 요구사항: FR-001, FR-002, FR-010
### P2 - 중단 뒤 이어서 한다
- 우선순위 이유: 프로세스가 종료되는 것이 세션이 죽는 가장 흔한 경로다. 이어하기를 출시하면 쓸모 있는 세션이 두 배가 된다.
- 독립 테스트: 세션 중 강제 종료하고 다시 실행해 남은 시간이 복원되는지 본다.
- 요구사항: FR-003
### 비목표
- 프리셋 라이브러리와 길이 직접 작성: 같은 25분에 설정 표면과 두 번째 사고 모델을 더한다.
- 기기 간 세션 동기화: 단일 기기 사례에 필요 없는 계정과 서버 의존성을 더한다.
- 유료 등급: 구독이나 단건 구매는 스토어 결제, 가격 화면, 이용 권한 상태를 더한다. 무료 타이머에는 필요 없다.
### 바뀌면 안 되는 동작
- FR-010 WHEN 세션 중 앱이 백그라운드에서 돌아오면, 시스템 SHALL CONTINUE TO 세션을 다시 시작하지 않고 남은 시간을 보여 준다.
## Functional requirements
| Id | 우선순위 | 요구사항 | 검증 |
|---|---|---|---|
| FR-001 | P0 | WHEN 사용자가 세션을 시작하면, 타이머 SHALL 고정 길이에서 카운트다운을 시작하고 남은 시간을 보여 준다. | 세션을 시작한다. 남은 시간이 1초마다 줄어든다. |
| FR-002 | P0 | IF 세션이 0에 닿으면, THEN 타이머 SHALL 완료 상태를 보여 주고 카운트를 멈춘다. | 1분짜리 시험 세션을 0까지 돌린다. 완료 상태가 나오고 카운트가 멈춘다. |
| FR-003 | P1 | WHEN 세션 중 프로세스가 종료되고 24시간 안에 다시 실행되면, 타이머 SHALL 남은 시간을 복원한다. [가정: 사용자는 하루 안에 돌아온다] | 남은 10분 시점에 프로세스를 종료하고 다시 실행해 10분이 보이는지 본다. |
| FR-004 | P1 | WHERE 기기가 무음 모드이면, 완료 상태 SHALL 소리 없이 나타나되 눈에 보이는 배너는 보여 준다. [확인 필요: 디자인 검토가 햅틱을 요구하는가?] | 무음 모드를 켜고 0까지 돌린다. 배너가 보이고 소리는 나지 않는다. |
| FR-010 | P1 | WHEN 세션 중 앱이 백그라운드에서 돌아오면, 시스템 SHALL CONTINUE TO 세션을 다시 시작하지 않고 남은 시간을 보여 준다. | 세션 중 앱을 2분 백그라운드로 보냈다가 돌아와, 줄어든 남은 시간에서 카운트다운이 이어지는지 본다. |
## Acceptance scenarios
### 세션 하나를 시작하고 끝낸다
```text
Scenario: 세션이 끝까지 진행된다 (FR-001, FR-002)
Given 세션이 없는 새 설치 상태
When 사용자가 시작을 누르고 25분을 기다린다
Then 완료 상태가 보이고 남은 카운트다운이 없다
Scenario: 세션이 백그라운드 복귀를 견딘다 (FR-001, FR-010)
Given 10분 전에 시작한 세션
When 사용자가 앱을 2분 동안 백그라운드로 보냈다가 돌아온다
Then 남은 시간이 약 13분으로 보이고 세션은 계속 실행 중이다
```
### 중단 뒤 이어서 한다
```text
Scenario: 강제 종료 뒤 남은 시간이 복원된다 (FR-003)
Given 남은 시간 10분인 세션이 시작된 상태
When 사용자가 앱을 강제 종료하고 24시간 안에 다시 실행한다
Then 타이머가 복원된 남은 시간을 보이고 계속 센다
Scenario: 이어하기 창을 넘겨 실행하면 새 세션이 된다 (FR-003)
Given 25시간 전에 종료된 세션
When 사용자가 앱을 다시 실행한다
Then 복원되는 세션이 없고 시작 상태가 보인다
```
## Platform requirements
### ios
`references/platforms/ios.ko.md`에서 채운다.
#### Release gate
| ID | 등급 | 항목 | 결론 | 근거 | 재확인 |
|---|---|---|---|---|---|
| I1 | `[M-조건]` | 5.1.1(v)에 따른 앱 안 계정 삭제 | 비해당 - 앱이 계정을 만들지 않고 로그인도 없어서 5.1.1(v)가 적용될 대상이 없다 | 위 제품 범위: 계정 없음, 동기화 없음 | 2027-02-07 |
| I2 | `[M-조건]` | 3.1.1에 따른 앱 내 구매 | 비해당 - 유료 디지털 재화나 서비스가 없다 | 비목표: 유료 등급 없음 | 2027-02-07 |
| I3 | `[M-조건]` | 3.1.2에 따른 구독 약관 | 비해당 - 구독이 없다 | 비목표: 유료 등급 없음 | 2027-02-07 |
| I4 | `[M]` | 릴리스가 다루는 모든 데이터 유형의 App Privacy 라벨 | 해당 - 세션 이벤트와 크래시 보고이며 신원에 연결되지 않고 추적에 쓰이지 않는다. 라벨은 아래 데이터 수집 매트릭스에서 읽는다 | 데이터 수집 매트릭스 | 2027-02-07 |
| I5 | `[M]` | 프라이버시 매니페스트 내용과 그 소유자 | 해당 - 매니페스트가 라벨과 같은 데이터 유형을 적고 추적 도메인이 없으며 소유자는 릴리스 책임자다 | 데이터 수집 매트릭스 | 2027-02-07 |
| I6 | `[M-조건]` | 2.1에 따른 심사용 데모 계정 | 비해당 - 로그인이 없어 심사자가 자격 증명을 받을 필요가 없다 | 위 제품 범위: 계정 없음 | 2027-02-07 |
| I7 | `[M]` | 4.2·4.2.2에 따른 최소 기능선 | 해당 - 타이머와 세션 상태, 완료 상태가 앱 자체 기능이고 웹사이트를 다시 포장한 것이나 링크 모음이 아니다 | 범위 P1 | 2027-02-07 |
| I8 | `[G]` | 맥락에 맞춘 알림 권한 요청 | 해당 - 완료 알림이 첫 세션 시작 때 요청하고, 타이머를 밝히는 문장 하나를 함께 보여 준다 | 범위 P1 | 2027-02-07 |
### android
`references/platforms/android.ko.md`에서 채운다.
#### Release gate
| ID | 등급 | 항목 | 결론 | 근거 | 재확인 |
|---|---|---|---|---|---|
| A1 | `[M]` | 릴리스가 선언하는 대상 API 레벨 | 해당 - 2026-08-31부터 적용되는 하한인 API 레벨 36을 대상으로 한다 | 출시 시점의 빌드 설정 | 2027-02-07 |
| A2 | `[M]` | Play Data safety 신고 | 해당 - 신고를 아래 데이터 수집 매트릭스에서 쓴다 | 데이터 수집 매트릭스 | 2027-02-07 |
| A3 | `[M]` | 유형별 수집·공유·목적·선택·일시 처리 | 해당 - 세션 이벤트와 크래시 보고이며 공유하지 않고 선택 사항이 아니며 일시 처리도 아니다 | 데이터 수집 매트릭스 | 2027-02-07 |
| A4 | `[M]` | 등록정보가 홍보하는 현재 기능으로 제한한 권한 목록 | 해당 - 알림 권한이 등록정보에서 홍보하는 완료 알림을 위한 것이다 | 범위 P1 | 2027-02-07 |
| A5 | `[M]` | 권한과 기능의 대응 표 | 해당 - 행 하나: 알림 권한, 완료 알림, 등록정보 스크린샷 2, 첫 세션 시작 때 요청 | 스토어 등록정보 계획 | 2027-02-07 |
| A6 | `[M-조건]` | 민감·제한 권한 선언 | 비해당 - 릴리스가 민감하거나 제한된 권한을 요청하지 않는다 | 위 권한 목록 | 2027-02-07 |
| A7 | `[M-조건]` | 디지털 재화의 Play 결제 | 비해당 - 디지털 재화를 팔지 않는다 | 비목표: 유료 등급 없음 | 2027-02-07 |
| A8 | `[M-조건]` | Play Billing 라이브러리 버전 | 비해당 - 앱이 Play Billing을 쓰지 않는다 | 비목표: 유료 등급 없음 | 2027-02-07 |
| A9 | `[M]` | 배포 산출물 형식 | 해당 - Android App Bundle을 올리고 어떤 배포 분할에도 기대지 않는다 | 출시 시점의 빌드 설정 | 2027-02-07 |
| A10 | `[G]` | Android vitals에서 읽는 안정성 하한 | 해당 - 대응 지표가 사용자 체감 크래시 비율 1.09% 미만과 ANR 비율 0.47% 미만을 앱 버전별로 Play Console에서 읽는다 | 지표 표의 목표 3 | 2027-02-07 |
| A11 | `[G]` | 상호작용 터치 타깃 48 dp 이상 | 해당 - 시작·정지 컨트롤이 작은 화면 하나와 큰 화면 하나에서 56 dp로 측정된다 | 레이아웃 검사 기록 | 2027-02-07 |
### Data collection matrix (ios and android)
| 데이터 유형 | 수집 | 제3자 공유 | 사용자 신원 연결 | 추적 사용 | 목적 | 선택 여부 | 일시 처리 |
|---|---|---|---|---|---|---|---|
| 세션 시작·종료 이벤트 | yes | no | no | no | 완료 세션 비율 측정 | no | no |
| 크래시 보고 | yes | no | no | no | 안정성 | no | no |
| 계정 식별자 | no | - | - | - | 계정이 없다 | - | - |
| 정확한 위치 | no | - | - | - | 요청하지 않는다 | - | - |
Apple 프라이버시 라벨 관점: 세션 이벤트와 크래시 보고를 사용 및 진단 데이터로 신고하고, 신원에 연결하지 않고 추적에 쓰지 않는다. 라벨은 다른 유형을 적지 않는다.
Play Data safety 관점: 같은 두 유형을 수집, 공유 안 함, 선택 사항 아님, 일시 처리 아님으로 신고한다. 신고는 다른 유형을 적지 않고 "수집하는 데이터 없음"도 주장하지 않는다.
## Assumptions
- A-001: 사용자는 세션 중 설정 없이 고정 25분 길이를 받아들인다
- 근거 등급: convention default
- 근거: 인용한 지원 스레드가 프리셋 과다에 관한 것이다
- 틀렸을 때: P1에 길이 선택이 더해지고 설정 비목표가 빠진다
## Open questions
- Q-001: 완료 시 디자인 검토가 햅틱을 요구하는가?
- 답할 사람: design
- 막힘: no
- 이력: Q: 햅틱이 필요한가? → A: unanswered
## Risks and dependencies
- 위험: 백그라운드 실행 제한이 카운트다운을 멈출 수 있다. 이른 신호는 복귀 시 세션이 건너뛰는 현상이다.
- 의존성: 스토어 등록에는 제출 전 최종 길이 문구가 필요하다.
## Change history
| 날짜 | 모드 | 바뀐 내용 |
|---|---|---|
| 2026-11-07 | create | 최초 문서 |
## Handoff
- 플랫폼: ios, android
- 규모: S
- P1 범위: 시작하고 끝내는 스토리와 FR-001, FR-002, FR-010
- 남은 막힘 질문: none
- 다음 단계 입력: 고정 길이, 완료 상태, 이어하기 창, iOS와 Android 출시 게이트 표, 공유 데이터 수집 매트릭스
```
## Release gate table
결정된 플랫폼 블록마다 표 하나를 두고, 그 플랫폼의 체크리스트 파일에서 채운다.
| 칸 | 내용 |
|---|---|
| ID | 체크리스트 항목 ID. 예: `I1`, `A2` |
| 등급 | 체크리스트의 등급을 그대로 옮긴다. `[M]`, `[M-조건]`, `[G]` |
| 항목 | 의무를 짧은 문장 하나로 쓴다. 수치 항목이면 임계값, 측정 방법, 분위수를 함께 쓴다 |
| 결론 | `해당`, 조건이나 이유가 붙은 `비해당`, 또는 `[확인 필요: <질문>]` |
| 근거 | 결론을 정하는 문서, 콘솔 화면, 측정 |
| 재확인 | 날짜가 붙은 값을 다시 확인하는 날짜. 날짜가 붙은 값이 없는 항목은 `none` |
- 불러온 체크리스트의 `[M]`·`[M-조건]` 항목은 모두 행을 갖는다. 조건이 거짓인 `[M-조건]` 행은 이유가 붙은 "비해당"으로 적고 행을 지우지 않는다.
- `[G]` 항목은 이 제품에 관련 있을 때만 행을 갖는다.
- `[확인 필요]`로 남은 `[M]` 행이 있으면 문서는 `status: draft`를 유지한다. 그 행은 세 개 상한에 세지 않고, 상한은 본문 절의 문장 안 표시에만 적용한다.
- 스토어 의무는 조항과 그 조항이 요구하는 관측 가능한 상태로 쓴다. "스토어 가이드라인을 준수한다"는 결론이 아니다.
## Data collection matrix
`ios`와 `android`를 함께 대상으로 할 때만 문서에 표 하나를 쓴다.
| 칸 | 내용 |
|---|---|
| 데이터 유형 | 스토어 양식이 쓰는 말로 적은 데이터 범주 |
| 수집 | `yes` 또는 `no` |
| 제3자 공유 | `yes` 또는 `no`. `yes`면 받는 쪽을 함께 적는다 |
| 사용자 신원 연결 | `yes` 또는 `no` |
| 추적 사용 | `yes` 또는 `no` |
| 목적 | 릴리스가 그 데이터를 다루는 이유 |
| 선택 여부 | `yes` 또는 `no`. 사용자가 데이터 제공을 거부해도 기능을 쓸 수 있으면 `yes` |
| 일시 처리 | `yes` 또는 `no`. 전송 중에만 처리하고 저장하지 않으면 `yes` |
- 매트릭스는 한 번만 쓴다. App Privacy 라벨과 Play Data safety 신고가 모두 이 표에서 읽고, 어느 쪽도 데이터 유형을 기억으로 다시 쓰지 않는다.
- 한 플랫폼만 다루고 다른 쪽은 다루지 않는 유형은 제품 결정이다. 차이와 그 이유를 매트릭스 옆에 적는다.
- 릴리스가 다루는데 매트릭스가 빠뜨린 유형은 매트릭스의 결함이다. 두 스토어 양식을 채우기 전에 고친다.
## Rules
- 골격의 절 이름을 그대로 복사한다. 검토자가 확인하는 이름이다.
- 메타 블록에는 플랫폼 판정과 규모 판정을 각각 이유 한 줄과 같은 줄에 적는다. 예: `Platforms: web, ios - 요청이 브라우저 제품과 App Store 출시를 지정했다`.
- 사실, 가정, 표시로 채울 수 없는 자리표시자는 지운다. 빈 절은 템플릿 흔적이 아니라 결함이다.
- 범위를 바꾸는 `[가정: …]`은 `A-###` 항목으로 다시 나타난다. 범위를 막는 `[확인 필요: …]`은 `Blocking: yes`인 `Q-###`이 된다.
- 스토리마다 정상 경로 하나와 실패·경계 하나를 인수 시나리오에 쓴다. 스토리 둘이면 시나리오 네 개다.
- 결정된 플랫폼 블록마다 출시 게이트 표를 둔다. 그 플랫폼 체크리스트의 `[M]`·`[M-조건]` 항목은 모두 결론이 붙은 행을 갖고, `[G]` 항목은 관련 있을 때만 행을 갖는다.
- 수치 게이트 항목은 임계값, 측정 방법, 분위수를 같은 칸에 적는다.
- `ios`와 `android`를 함께 판정하면 데이터 수집 매트릭스를 문서에 한 번만 쓰고, Apple 프라이버시 라벨 관점과 Play Data safety 관점을 그 표에서 끌어낸다.
- 스토어 의무는 조항과 그 조항이 요구하는 관측 가능한 상태로 쓴다. 조항과 상태를 밝히지 않고 가이드라인을 따르라고만 하는 문장은 요구사항이 아니다.
- 문서 전체에서 `[확인 필요: …]`는 최대 3개다. 이 상한은 본문 절의 문장 안 표시를 세고, 출시 게이트 표의 결론으로 놓인 `[확인 필요: <질문>]`은 세지 않는다. 게이트 행이 하나라도 `[확인 필요]`이면 문서는 `status: draft`를 유지한다.
- 다음 단계 입력은 핸드오프 블록에서만 설명한다. 이 문서에는 태스크 목록, 설계, 흐름이 들어가지 않는다.
## Sources
> 확인 2026-11-07.
| Claim | Source |
|---|---|
| 정본 산출물 하나와 짧은 질문 예산 | [snarktank/ai-dev-tasks create-prd](https://raw.githubusercontent.com/snarktank/ai-dev-tasks/main/create-prd.md) - "Limit questions to 3-5 critical gaps in understanding." |
| N/A 대신 적용되지 않는 절을 지움 | [spec-kit specify](https://raw.githubusercontent.com/github/spec-kit/main/templates/commands/specify.md) - "When a section doesn't apply, remove it entirely (don't leave as 'N/A')." |
| 독립 테스트 가능한 스토리와 번호 요구사항 | [spec-kit spec-template](https://raw.githubusercontent.com/github/spec-kit/main/templates/spec-template.md) - "Each user story/journey must be INDEPENDENTLY TESTABLE" |
| WHEN/SHALL 요구사항 문장 | [Kiro feature specs](https://kiro.dev/docs/specs/feature-specs.md) - "WHEN [condition/event] THE SYSTEM SHALL [expected behavior]" |
| 상태형과 원치 않는 사건형 요구사항 | [EARS](https://alistairmavin.com/ears/) |
| 바뀌지 않는 동작의 `SHALL CONTINUE TO` | [Kiro bugfix specs](https://kiro.dev/docs/specs/bugfix-specs.md) - "WHEN [condition] THEN the system SHALL CONTINUE TO [existing behavior]" |
| 공백 지점의 문장 안 표시 | [deanpeters prd-development](https://github.com/deanpeters/Product-Manager-Skills) - "Tag inline where the gap appears, not just at the end." |
| 가정과 열린 질문을 본문 사실과 분리 | [phuryn create-prd](https://github.com/phuryn/pm-skills) - "Don't invent. What you don't know goes to 7.4 Assumptions and open questions, clearly marked, not into the body as fact." |
| 지표 집합의 대응 지표 | [TerminalSkills prd-writing](https://github.com/TerminalSkills/skills) - "Counter-metrics: [Metrics we don't want to hurt]" |
| 문서 끝의 핸드오프 블록 | [Citadel prd](https://github.com/SethGammon/Citadel) |
| 두 스토어 프라이버시 양식이 함께 읽는 데이터 목록 하나 | [App Privacy Details](https://developer.apple.com/app-store/app-privacy-details/) - "This information is required to submit new apps and app updates to the App Store."; [Play Data safety](https://support.google.com/googleplay/android-developer/answer/10787469) - "Even developers with apps that do not collect any user data must complete this form" |
| 내부 구현 메커니즘을 이름으로 쓰지 않음 | [ai-conductor prd](https://github.com/jstoup111/ai-conductor) - "It MUST NOT name the new internal mechanism by which this feature is built." |
### 근거 등급
`LOCAL` - 절 순서와 예시는 이 패키지의 설계다. 문장 형식은 EARS와 Kiro 문서에서 인용했고, 표시와 가정 규칙은 인용한 지침을 각색했다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |