v0.dev PRD 작성기 — 프로 버전(v0.dev PRD Generator (Pro Ver.))
이 프롬프트는 제품 리더가 구조화된 PRD 전체를 v0.dev에 입력하고, 그 결과로 여러 파일로 나뉜 자동 모듈형 Next.js 19 스캐폴드(scaffold)를 받을 수 있게 해줍니다. v0.dev는 코드를 app/, components/, hooks/, lib/, tests/, Tailwind 테마 등 작은 단위 파일로 분해하고, 각 파일은 100 LOC 이하로 제한하며 `#file` 지시자(directive)를 붙여 바로 저장소에 붙여 넣을 수 있게 만듭니다. 생성 후에는 Supabase 프로젝트를 연결하라는 간단한 팝업이 뜰 수 있습니다. 그 경우 앱 내 안내를 따라 실제 백엔드를 연결하면 됩니다.
문서가 아니라 코드를 생성하는 AI 네이티브 PRD
Product Requirements Document는 지난 10년 동안 천천히 힘을 잃어왔습니다. 프로덕트 매니저는 문서를 쓰고, 엔지니어는 훑어보고, 스프린트(sprint) 1이 지나면 아무도 업데이트하지 않습니다. 하지만 지금은 새로운 종류의 PRD가 등장하고 있습니다. 사람만을 위한 문서가 아니라, v0.dev 같은 AI 코드 생성 도구에 구조화된 입력으로 바로 들어갈 수 있도록 설계된 PRD입니다.
GitHub의 2023 개발자 설문에 따르면 개발자의 92%가 이미 AI 코딩 도구를 사용하거나 실험 중입니다. 프로덕트 매니저에게 이 사실이 의미하는 바는 분명합니다. 이제 여러분이 쓰는 문서는 점점 더 기계에도 읽히고 있고, 기계는 사람과 다른 것을 필요로 합니다.
문제
전통적인 PRD는 사람의 이해를 최적화합니다. 서술형 문장, 문맥이 섞인 설명, 숙련된 엔지니어가 알아서 해석할 암묵적 가정이 들어갑니다. 하지만 AI 코드 생성기는 모호함을 처리하지 못합니다. 명시적인 구조, 정밀한 컴포넌트 계층(component hierarchy), 모호하지 않은 수락 기준(acceptance criteria)이 필요합니다.
이 간극은 두 단계의 번역 과정을 만듭니다. PM이 PRD를 쓰고, 엔지니어가 PRD를 해석하고, 다시 엔지니어가 AI 도구용 프롬프트를 씁니다. 이 번역 단계마다 드리프트(drift)가 생깁니다. 실제 코드가 생성될 때쯤이면 PM이 의도한 것과 달라져 있을 수 있습니다.
2024년 Stack Overflow 설문에 따르면 개발자의 76%는 요구사항이 불명확한 것이 프로젝트 지연의 가장 큰 원인이라고 답했습니다. AI가 루프에 들어오면, 모호한 요구사항은 단지 엔지니어를 느리게 만드는 데 그치지 않습니다. 잘못된 코드를 만들어내고, 그 코드를 고치는 데 처음부터 직접 작성하는 것보다 더 오래 걸리게 만듭니다.
이 프롬프트의 작동 방식
v0.dev PRD 작성기(v0.dev PRD Generator)는 AI 코드 생성을 전제로 최적화된 요구사항 문서를 만듭니다. 서술형 설명 대신, v0.dev와 유사 도구가 직접 소비할 수 있는 구조화된 스펙(specification)을 생성합니다.
이 프롬프트는 기능 의도를 받아 컴포넌트 트리(component tree), 상태 관리(state management) 명세, 데이터 플로우(data flow) 정의, UI 동작 설명으로 바꿔줍니다. 또한 AI 코드 도구가 안정적으로 파싱하는 형식으로 결과를 생성합니다. 예를 들어 일관된 heading hierarchy가 있는 구조화된 markdown, 명시적인 props 정의, 열거된 엣지 케이스 같은 형식입니다.
그 결과, 이해관계자 리뷰에 충분히 사람이 읽을 수 있으면서도, 동시에 실제 프로토타입을 바로 생성할 수 있을 만큼 기계 친화적인 PRD가 만들어집니다.
언제 사용할까
- v0.dev 같은 AI 도구로 프로토타이핑할 때 아이디어에서 동작하는 UI까지 빠르게 가고 싶을 때
- 해커톤(hackathon)이나 빠른 프로토타이핑 상황에서 개념에서 코드까지의 속도가 중요할 때
- AI 페어 프로그래밍(pair programming)을 쓰는 엔지니어링 팀과 협업할 때 구조화된 입력이 필요할 때
- 디자인 시스템에 맞춘 기능 개발처럼 컴포넌트 패턴이 예측 가능한 경우
흔한 함정
시각 디테일을 과하게 명시하기. AI 코드 생성기는 미적인 부분을 꽤 잘 처리합니다. 픽셀 값보다 동작, 데이터 플로우, 엣지 케이스에 PRD를 집중하세요.
사람 독자를 잊기. AI 최적화 PRD라 해도 왜 이 방향을 택하는지 설명하는 컨텍스트 섹션은 필요합니다. 이해관계자는 여전히 방향을 이해하고 승인해야 합니다.
생성된 코드를 곧바로 운영 코드로 취급하기. Gartner는 2025년까지 AI 생성 코드가 초기 코드 산출물의 50% 이상을 차지하더라도, 보안, 성능, 유지보수성 측면에서 여전히 상당한 인간 리뷰가 필요할 것으로 봅니다. 이 PRD는 출발점을 제공할 뿐, 결승선을 제공하지는 않습니다.
참고 자료
Sources
- The State of Open Source and AI — GitHub
- Developer Survey 2024 — Stack Overflow
- What's New in AI from the Gartner Hype Cycle — Gartner
Prompt details
Ready to try the prompt?
Open the live prompt detail page for the full workflow.