플랫폼 PRD 빌더은(는) 무엇을 하나요?
이 스킬을 사용하여 대략적인 입력을 구조화되고 구현 준비가 완료된 제품 요구사항으로 변환하세요. 단순히 번역하지 마세요. 이해하고, 재구성하고, 풍부하게 만들고, 정확한 범위를 유지하세요.
운영 모드
요청을 충족할 수 있는 가장 가벼운 모드를 선택하세요:
- 전체 PRD 작성: 복잡하거나 시스템 간 연계가 필요한 요구사항에 대한 완전한 PRD를 생성합니다.
- 섹션 작성: 배경, 범위, 흐름, API/데이터 변경 사항, 또는 출시와 같이 요청된 섹션만 작성합니다.
- 재작성/다듬기: 결정 사항을 변경하지 않고 구조, 명확성, 영어 또는 이중 언어 표현을 개선합니다.
- 입력 정규화: 초안 작성 전에 흩어진 노트를 확정된 결정, 가정, 누락된 결정, 엔지니어링이 읽을 수 있는 언어로 변환합니다.
- 템플릿 선택: 요청이 반드시 전체 PRD가 아닌 경우 적절한 산출물 유형을 선택합니다.
- 방향 정렬 초안: 전체 PRD로 확장하기 전에 가벼운 개념/정렬 버전을 만듭니다.
첫 번째 행동
간략하게 식별하세요:
- 비즈니스 시나리오
- 플랫폼 기능
- 관련 시스템
- 현재 단계 및 제외 사항
- 산출물 유형: 전체 PRD, PRD 섹션, 1페이지 BRD, 이중 언어 초안, 영어 재작성, 표, 또는 흐름 설명
사용자가 영향 또는 타당성만 요청하는 경우, 아직 PRD를 작성하지 말고 먼저 영향 분석을 사용하세요.
산출물 유형이 명확하지 않은 경우, 가장 작은 유용한 산출물을 제안하고 그 선택이 전달 위험을 초래하지 않는 한 계속 진행하세요.
0단계: 단계 감지
초안 작성 전에 사용자의 단계를 분류하세요:
- 아이디어만 있음: 먼저 방향 정렬 초안을 만듭니다.
- 흩어진 노트: 먼저 결정, 가정, 누락된 결정을 정규화합니다.
- 범위 미확정: 현재 단계 요구사항을 작성하기 전에
platform-scope-checker로 안내합니다. - 초안 작성 준비 완료: 요청된 PRD 또는 섹션을 작성합니다.
- 기존 초안 있음: 구조를 개선하거나 사용자가 피드백을 원하는 경우
platform-prd-reviewer로 안내합니다. - RFC 세부 사항 요청: PRD에 제품 의미론을 유지하고 구현 세부 사항은 엔지니어링 후속 조치로 안내합니다.
구축 챌린지 게이트
요청을 구축 중심의 PRD로 전환하기 전에, 동일한 비즈니스 목표를 다음을 통해 달성할 수 있는지 간략히 검토하세요:
- 기존 플랫폼 기능
- 설정
- 운영 프로세스 또는 임시 수동 처리
- 더 작은 워크플로우 변경
- 단계적 출시
- 현재 단계의 전체 동작 없이 호환성 플레이스홀더
답변이 불분명하거나 구축 위험이 높은 경우, 전체 PRD를 작성하기 전에 범위 검사를 권장합니다.
2단계 전달
모호하거나, 0-to-1이거나, 대규모 교차 시스템 요구사항의 경우, 두 단계를 선호합니다:
- 방향 정렬 초안: 문제, 대상 사용자/운영자, 플랫폼 기능, 범위 경계, 핵심 흐름, 소유권, 가정, 미결 결정.
- 세부 PRD: 시스템별 요구사항, 필드/API/데이터 변경 사항, 상태/예외 사례, 출시/운영, 수용 기준, 위험.
핵심 제품 방향, MVP 경계, 또는 진실 공급원이 여전히 불확실한 경우 세부 PRD로 바로 넘어가지 마세요.
사용하지 말아야 할 경우
다음과 같은 경우 첫 번째 행동으로 이 스킬을 사용하지 마세요:
- 비즈니스 문제 또는 대상 사용자가 여전히 논쟁 중인 경우: 먼저
platform-product-guide로 방향을 명확히 하세요. - 질문이 "지금 이걸 해야 하나?"인 경우: 먼저
platform-scope-checker를 사용하세요. - 사용자가 기존 산출물에 대한 리뷰 피드백만 원하는 경우:
platform-prd-reviewer를 사용하세요. - 요청이 순수 엔지니어링 RFC, 코드 설계, 또는 구현 계획이고 제품 요구사항 작업이 없는 경우.
PM 입력 정규화
입력이 모호하거나, 비기술적이거나, 흩어진 노트로 작성된 경우, 초안을 작성하기 전에 먼저 엔지니어링이 읽을 수 있는 제품 결정으로 변환하세요. 사용자에게 기술 용어를 사용하도록 요구하지 마세요.
결정이 누락된 경우 이 가벼운 출력을 사용하세요:
알려진 결정
- ...
누락된 결정
- ...
엔지니어링 관련 번역
- "승인 기록 필요"는 감사 로그 필드, 기록 시점, 조회 접근, 보존 기간에 대한 결정이 필요함을 의미합니다.
- "다른 시스템에 알림"은 콜백 시점, 재시도, 타임아웃, 실패 처리, 상태 일관성에 대한 결정이 필요함을 의미합니다.
기술 레이블 질문 대신 비즈니스 언어 질문을 하세요:
- "멱등성 키는 무엇인가요?" 대신 "동일한 요청이 두 번 제출되면 시스템이 새 레코드를 생성해야 하나요, 거부해야 하나요, 아니면 기존 레코드를 반환해야 하나요?"
- "콜백 재시도 전략은 무엇인가요?" 대신 "수신 시스템에 알릴 수 없는 경우 사용자는 무엇을 보게 되고, 누가 수정하며, 얼마나 오래 해결되지 않은 상태로 남을 수 있나요?"
- "진실 공급원은 누구인가요?" 대신 "두 시스템이 다른 상태를 표시하면 어느 것을 신뢰해야 하나요?"
- "호환성 전략은 무엇인가요?" 대신 "출시 후 기존 레코드나 진행 중인 프로세스가 영향을 받나요?"
- "상태 머신을 정의하세요" 대신 "이 요청은 생성부터 완료까지 어떤 상태를 가질 수 있으며, 각 상태에서 어떤 작업이 허용되나요?"
가정 및 증명 원장
중요한 결정이 대략적인 노트에서 추론된 경우, 최종 확정 전에 이를 표면화하세요:
가정
- A1: ...
증거 / 출처
- E1: 사용자 노트 / 프로토타입 / 이전 PRD / 회의록 / 명시적 지시 사항
확인 필요
- C1: ...
가정을 조용히 요구사항으로 바꾸지 마세요. 사용자가 진행을 요청하는 경우, 미해결 항목을 알려진 소유자/종속성과 함께 미결 질문에 남겨두세요.
템플릿 선택
하나의 무거운 구조를 강제하는 대신 산출물 유형별로 템플릿을 선택하세요.
짧은 기능 PRD:
- 배경
- 목적
- 범위
- 요구사항
- API / 데이터 변경 사항
- 예외 사례
- 첨부 파일 / 링크
API / 필드 변경 노트:
- 배경
- 변경된 계약
- 필드 표
- 유효성 검사 / 기본 동작
- 하위 호환성
- 다운스트림 소비자
- 예시
설정 UI PRD:
- 배경
- 목표
- 페이지 경로 / 진입점
- 목록 필드
- 필터 / 조회 동작
- 생성 / 편집 동작
- 유효성 검사 규칙
- 권한 / 감사
- 첨부 파일 / 프로토타입
마이그레이션 PRD:
- 배경
- 범위
- 소스 / 대상 시스템
- 마이그레이션 흐름
- 데이터 매핑
- 유효성 검사 / 조정 체크리스트
- 전환 / 롤백
- 미결 질문
공식 / 규칙 로직 PRD:
- 배경
- 규칙 형식
- 필드 정의
- 처리 로직
- 예시
- 예외 사례
- 하위 호환성
기본 PRD 구조
사용자가 다른 템플릿을 제공하지 않는 한 이 구조를 사용하세요:
- 배경
- 목표
- 범위
- 행위자 / 시스템
- 전체 흐름
- 흐름 세부 사항
- 시스템별 요구사항
- API / 데이터 변경 사항
- 시나리오 및 예외 사례
- 출시 / 운영
- 미결 질문
- 종속성 / 위험
짧은 섹션의 경우 관련 헤더만 유지하되 동일한 사고 순서를 유지하세요.
플랫폼 흐름 모델러 사용 시기
다음과 같은 경우 platform-flow-modeler를 사용하세요:
- 요구사항에 3개 이상의 시스템, 수명 주기/상태 변경, 콜백/재시도/타임아웃, 롤백/취소/재제출, 조정, 정산, 마이그레이션 또는 수동 폴백이 포함될 때
- 전체 흐름, 흐름 세부 사항, 시나리오 및 예외 사례, 상태 전이 또는 운영 섹션을 작성하기 전에
먼저 흐름 테이블을 만들고, 그런 다음 해당 테이블을 PRD 산문, 시스템별 요구사항, 시나리오, 수용 기준 및 미결 질문으로 변환하세요.
출력 규약
모든 PRD 스타일 출력은 다음 사항을 테스트 가능하게 만들어야 합니다:
- 문제 및 "왜 지금인가"
- 현재 단계 목표
- 범위 경계
- 주요 흐름 및 주요 예외 흐름
- 여전히 열려 있는 제품 결정
- 수용 기준 또는 시나리오 매트릭스
- 교차 시스템 동작에 대한 소유자/진실 공급원
- 관련된 경우 출시, 롤백 또는 임시 수동 처리
기본 응답 형태:
- 선택한 산출물 유형에 대한 간략한 메모 (유용한 경우)
- 작성된 PRD 콘텐츠 또는 요청된 섹션
- 가정 및 미결 결정 (있는 경우)
- 제안된 다음 리뷰 경로: 범위 검사, PRD 리뷰, RFC 후속 조치 또는 이해 관계자 확인
이 스킬은 조언뿐만 아니라 산출물을 생성해야 합니다. 산출물을 안전하게 생성할 수 없는 경우 누락된 결정 원장과 다음 조치를 출력하세요.
세부 PRD 템플릿 및 산출물별 출력 규약에 대해서는 작업에 전체 PRD, 0-to-1 플랫폼 PRD, 마이그레이션 PRD, 설정 UI PRD 또는 API/데이터 변경 노트가 포함된 경우 references/prd-output-contract.md를 참조하세요.
시나리오 및 수용 기준
시나리오 및 예외 사례 섹션의 경우, QA 및 엔지니어링 정렬을 개선할 때 Given/When/Then 수용 기준을 사용하세요:
**시나리오: [이름]**
- Given: [전제 조건: 시스템 상태, 행위자, 데이터, 설정]
- When: [트리거 작업]
- Then: [예상 결과: 최종 상태, 사용자/운영자에게 보이는 결과, 다운스트림 동기화, 감사 기록]
관련된 경우 다음 시나리오 유형을 포함하세요:
- 행복 경로
- 유효성 검사 실패: 필드 누락, 잘못된 값, 중복 제출
- 다운스트림 시스템 실패: 콜백 타임아웃, API 오류, 부분 실패
- 동시 또는 중복 제출
- 상태 전이 예외 사례: 종료 상태에서 재제출, 흐름 중간 취소
- 롤백 또는 되돌리기
- 수동 폴백: 운영자 개입 또는 예외 큐 항목
- 권한 경계: 허용되지 않은 행위자 또는 소스 시스템 불일치
각 Then 절을 테스트 가능하게 만드세요. 최종 상태, 사용자/운영자에게 보이는 결과, 다운스트림 시스템에 알림이 전송되는지 여부, 감사/이벤트 레코드가 생성되는지 여부를 명시하세요.
시나리오 매트릭스가 클 경우 간결한 테이블을 사용하세요:
| 시나리오 | 전제 조건 | 트리거 | 최종 상태 | 사용자/운영자 결과 | 다운스트림 | 감사 |
|---|---|---|---|---|---|---|
API / 데이터 테이블 스타일
API 또는 데이터 변경 사항의 경우 기본적으로 다음이 포함된 테이블을 사용하세요:
- 필드
- 데이터 유형 / 유형
- 필수 여부
- 값 / 유효성 검사
- 설명
- 예시
- 변경 유형: 신규 / 기존 / 제거 (해당되는 경우)
- 소유자 / 소비자 (소유권이 중요한 경우)
0-to-1 플랫폼 PRD 추가 사항
새로운 플랫폼/인프라 기능의 경우 다음을 추가하세요:
- 플랫폼 방향 및 설계 원칙
- 설정 객체와 런타임 객체
- 소유권/진실 공급원 테이블
- 수명 주기/상태 머신
- 버전 관리 및 스냅샷 동작
- 콜백, 재시도, 타임아웃 및 멱등성 동작
- 감사/이벤트 로깅
- 권한 및 소스 시스템 격리
- MVP 제외 사항 및 향후 반복
- 역할, 데이터 범위 및 운영 지역별 UI/워크스페이스 모델
작성 규칙
- 영어 출력이 요청된 경우 대략적인 노트를 전문적인 영어로 변환하세요.
- 실제 시스템 이름이나 팀 산출물을 반영하는 경우 중국어/영어 혼합 용어를 유지하세요.
- 독자가 이해하고 구현하는 데 필요한 설명을 추가하되, 비즈니스 결정을 임의로 만들지 마세요.
- 입력 품질이 고르지 않은 경우 최종 PRD를 작성하기 전에 비즈니스 계층과 엔지니어링 협업 계층으로 정규화하세요.
- 검토 가능성을 위해 번호가 매겨진 계층 구조를 사용하세요.
- 필드, API, 소유권, 시나리오, 계산, 상태 전이 및 미결 질문에는 표를 사용하세요.
- 여러 시스템이 변경되는 경우 시스템별로 요구사항을 분리하세요.
- 제품이 읽을 수 있는 섹션은 제품이 읽기 쉽게 유지하고, 낮은 수준의 세부 사항은 API/데이터 섹션이나 미결 질문으로 이동하세요.
- 사용자가 작업의 기반으로 사용하라고 한 경우 제공된 프로토타입이나 기존 PRD 구조를 따르세요.
범위 규율
항상 다음을 분리하세요:
범위 내범위 외이 단계에서 지원되지 않음향후 반복
명시적 제외, 호환성 노트 또는 향후 반복이 아닌 한, 현재 단계 요구사항에 향후 단계 기능을 포함하지 마세요.
흐름 및 데이터 요구사항
교차 시스템 작업의 경우:
- 해당되는 경우 생성/조회/콜백/업데이트/정산/조정 흐름을 별도로 설명하세요.
- 지속성 지점 및 상태 변경을 식별하세요.
- 설정 시간 필드와 런타임 필드를 별도로 정의하세요.
- 스냅샷 필드와 동적으로 해결되는 필드를 구분하세요.
- 필드 이름을 신중하게 사용하세요. 단수/복수 명명은
portalCode와portalCodes와 같이 범위를 인코딩할 수 있습니다.
가드레일
- 사용자가 재작성을 요청하지 않는 한, 과거 PRD는 학습/참고 자료로 취급하세요.
- 이전 프로젝트의 관련 없는 컨텍스트를 주입하지 마세요.
- 사용자가 요구사항을 요청할 때 코드를 출력하지 마세요.
- 마케팅 언어로 지나치게 다듬지 마세요.
- 미결 결정을 숨기지 말고, 알려진 경우 소유자/종속성과 함께 명확하게 나열하세요.
표시해야 할 일반적인 실수
- 방향 정렬이 준비되기 전에 세부 요구사항을 작성하는 것.
- 가정을 요구사항으로 바꾸면서 레이블을 붙이지 않는 것.
- 현재 MVP와 향후 반복 동작을 혼합하는 것.
- 페이지/버튼 동작만 작성하고 상태, 소유권 및 예외 처리는 암시적으로 남겨두는 것.
- PRD에서 데이터베이스, 큐, 재시도 작업 또는 서비스 설계를 과도하게 규정하는 것.
- 비즈니스 목표와 범위 경계를 확인하지 않고 구현 요청을 제품 준비 완료된 것으로 취급하는 것.
라우팅
- 비즈니스 방향, 플랫폼 추상화 또는 결정 프레이밍이 준비되지 않은 경우
platform-product-guide로 라우팅하세요. - 흐름 중심 섹션은 PRD 콘텐츠로 변환하기 전에
platform-flow-modeler로 라우팅하세요. - 현재 단계 포함, MVP 크기 또는 숨겨진 복잡성이 해결되지 않은 경우
platform-scope-checker로 라우팅하세요. - 초안 작성 후 사용자가 준비 상태, 격차 또는 점수를 원하는 경우
platform-prd-reviewer로 라우팅하세요. - PRD에 제품 의미론을 유지하면서 RFC 수준 구현 질문은 엔지니어링 후속 조치로 라우팅하세요.
품질 체크리스트
최종 확정 전에 다음을 확인하세요:
- 문서가 무엇을 구축해야 하는지와 그 이유를 설명합니다.
- 범위가 명시적입니다: 범위 내, 범위 외, 현재 지원되지 않음, 향후.
- 요구사항이 QA 또는 엔지니어링 리뷰에 충분히 테스트 가능합니다.
- 교차 시스템 소유권 및 진실 공급원이 표시됩니다.
- 가정이 확정된 결정과 분리됩니다.
- 기술적 고려 사항이 구현을 과도하게 규정하지 않고 표면화됩니다.
- 다음 경로 또는 리뷰 단계가 명시적입니다.
참고 자료
references/prd-output-contract.md: 세부 템플릿, 산출물별 규약 또는 품질 체크리스트가 필요할 때 로드하세요.