PRD 뜻, 대표가 넣자던 기능 3개는 왜 빠졌을까?

회의에서 “이 기능 만들자”는 말이 나오면 누군가는 그 말을 개발자가 보고 만들 수 있는 문서인 PRD로 옮겨야 합니다. 앤트로픽의 공식 기획 플러그인 Product Management(프로덕트 매니지먼트)에 든 write-spec 스킬은 아이디어나 메모를 PRD 틀에 맞춰 써 줍니다. 무료이지만 클로드 유료 요금제의 사용량을 씁니다. 가상 서비스의 회의 메모로 클로드 코드(Claude Code)에 같은 요청을 스킬 없이 2번, 스킬을 불러 2번 보냈습니다.

세 줄 요약
  1. 회의 메모·해지 사유·고객 문의 파일 세 개를 주면 4번 모두 1분 남짓에 PRD를 썼습니다. 대표가 “하는 김에” 얹은 기능 3개는 4번 모두 이번 범위에서 뺐습니다.
  2. 메모에 숨겨 둔 마감 시각 문제도 4번 모두 풀었습니다. 차이는 문서의 꼴입니다. 스킬을 부른 2번만 요구사항을 우선순위 세 단계로 나누고, 항목마다 “이러면 완성” 기준을 붙였습니다.
  3. 스킬 안내문의 기준으로 채점하니 스킬 없이 5·5점, 스킬 9·10점이었습니다. 사용량 차이는 한 번에 0.03~0.07달러(API 단가)였습니다.

결과부터 보기: 같은 회의 메모로 받은 PRD 4개

실습 자료는 가상의 반찬 정기배송 서비스 “찬찬식탁”의 파일 세 개입니다. 서비스와 사람 이름은 모두 지어낸 것입니다. 만들려는 기능은 구독자가 앱에서 한 주 배송을 쉬는 “배송 건너뛰기”입니다. 세 파일에는 아래 내용을 넣어 두었습니다.

자료넣어 둔 것
회의_메모.txt대표는 건너뛰기에 더해 메뉴 바꾸기·선물하기·포인트 적립도 같이 넣자고 함. 개발은 4주 안에 건너뛰기 하나만 가능하다고 함. 12월 15일 연말 프로모션 전에 열어야 함. 결제는 화요일 오전 9시이고 결제 48시간 전까지만 자동으로 멈출 수 있음. 재료 발주는 월요일 낮 12시에 확정. 못 정한 것 3개(연속 몇 주까지, 쿠폰을 줄지, 마감 뒤 요청)
해지_사유.csv8~10월 해지 설문 150건. “이번 주만 쉬고 싶은데 방법이 없어서”가 54건(36%)으로 1위
고객_문의.txt10월 카톡 문의 7건. “한 주만 빼 주세요”, “빼 달라 했는데 배송이 왔어요” 등. 선물하기 문의도 1건

숨겨 둔 문제는 마감 시각입니다. 발주 확정(월요일 낮 12시)만 보고 건너뛰기 마감을 월요일로 잡으면 결제를 자동으로 멈출 수 없습니다. 화요일 오전 9시 결제의 48시간 전인 일요일 오전 9시가 먼저 오기 때문입니다.

스킬 없이 1번 → 스킬 2번 · Claude Code · 소넷 5.5 · 생각 깊이 중간

직접 눌러 보기: 스킬 없이 1 · 스킬 없이 2 · 스킬 1 · 스킬 2. 4번 모두 결과는 “PRD.md” 한 개였고, 내용은 고치지 않고 웹페이지로만 바꿨습니다.

조건건너뛰기 마감요구사항 정리점수
스킬 없이 1일요일 오전 9시상황별 줄글5
스킬 없이 2일요일 오전 9시표(필수·권장 두 단계)5
스킬 1일요일 오전 9시P0 6개·P1 4개·P2, 항목마다 완성 기준9
스킬 2일요일 오전 9시P0 7개·P1 3개·P2, 항목마다 완성 기준10

직접 실행 확인한 날짜 2026-11-12

실행 환경
macOS 26.1 · Claude Code 2.1.299 · 소넷(Sonnet) 5.5 · 생각 깊이 중간 (4번 모두 같은 설정)
설치 난이도
명령 두 줄(공식 README)
비용
플러그인 무료. 한 번에 API 단가로 스킬 없이 0.30~0.33달러, 스킬 0.36~0.37달러어치
라이선스
Apache-2.0 · anthropics/knowledge-work-plugins(별 35,502개, 2026-11-12 기준)

PRD 뜻: 무엇을 왜 만드는지 적는 문서

PRD(Product Requirements Document)는 제품 요구사항 문서입니다. 만들 기능이 누구의 어떤 문제를 푸는지, 어디까지 만들고 어디서 멈추는지, 다 만들었는지를 무엇으로 판단하는지 적습니다. 국내에서는 보통 기능 기획서라고도 부릅니다. 화면 그림이나 코드 설계는 보통 다음 단계 문서로 넘깁니다.

write-spec 스킬 안내문이 정한 PRD의 칸은 여덟 개입니다.

칸적는 것
문제 정의누가 어떤 문제를 겪는지, 풀지 않으면 무엇을 잃는지 2~3문장. 근거 자료를 붙임
목표숫자로 잴 수 있는 결과 3~5개. “버튼 만들기”가 아닌 “해지 절반으로”처럼 결과로 적음
비목표이번에 하지 않는 것 3~5개와 이유. 만드는 도중에 범위가 불어나는 것을 막는 칸
사용자 스토리“~인 사용자로서, ~하고 싶다, ~하기 위해” 꼴의 문장. 오류·마감 뒤 같은 예외도 포함
요구사항P0(없으면 출시 못 함)·P1(곧 이어서)·P2(이번엔 안 하지만 막지 않게 설계)로 나누고 항목마다 완성 기준을 붙임
성공 지표출시 직후 바로 움직이는 선행 지표와 몇 달 뒤 움직이는 후행 지표. 목표 숫자와 재는 시점
열린 질문아직 답이 없는 질문. 누가 답해야 하는지, 시작 전에 꼭 정해야 하는지를 표시
일정바꿀 수 없는 마감, 다른 팀·외부 서비스에 걸린 일, 나눠서 낼 순서

대표가 넣자던 기능 3개: 4번 모두 뺐습니다

회의 메모에서 대표는 건너뛰기를 만드는 김에 메뉴 바꾸기, 선물하기, 포인트 적립도 같이 넣자고 했습니다. 4번 모두 이 셋을 이번 범위에서 뺐고, 이유로 개발 쪽의 “4주 안에 건너뛰기 하나만 가능, 넷 다는 불가능”을 들었습니다. 스킬을 부른 2번은 이유를 기능마다 따로 적었습니다. 포인트 적립은 해지 사유 어디에도 근거가 없고, 선물하기는 문의 7건 가운데 1건뿐이라는 식입니다.

숨겨 둔 마감 시각 문제도 4번 모두 풀었습니다. 건너뛰기 마감을 일요일 오전 9시로 잡았고, 결제를 멈출 수 있는 시한이 발주 확정보다 먼저 온다는 이유를 적었습니다.

스킬 없이 2번째 PRD의 핵심 규칙 마감 시각. 일요일 09:00 API 마감, 월요일 12:00 발주, 화요일 09:00 결제, 목요일 배송 순서와 시점별 처리 표
스킬 없이 2번째 PRD의 마감 시각 규칙. 일요일 09:00을 마감으로 정한 표와 이유 · Claude Code · 소넷 5.5 · 생각 깊이 중간

회의에서 못 정한 3개에는 4번 모두 같은 임시값을 달았습니다. 연속 건너뛰기는 2주까지로 하되 나중에 바꿀 수 있는 설정값으로 두고, 쿠폰은 첫 출시에서 빼고, 마감 뒤 요청은 앱에서 막고 고객센터로 안내합니다. 4번 모두 이 값이 확정이 아니며 대표와 운영 담당이 정해야 한다고 적었습니다.

해지를 얼마나 줄일지의 목표도 4번 모두 같았습니다. “쉬고 싶은데 방법이 없어서” 해지를 지금의 절반으로 줄인다는 것입니다. 자료에 없는 숫자라서 4번 가운데 3번은 이 목표가 제안이나 가정이라고 표시했습니다.

스킬을 불렀을 때 달라진 것

첫 번째 차이는 요구사항입니다. 스킬 없이 받은 1번째는 요구사항을 상황별 줄글로 썼습니다. 2번째는 표로 정리하고 필수·권장 두 단계를 달았습니다. 어느 쪽에도 “어떻게 되면 완성인지”는 따로 없었습니다.

스킬 없이 1번째 PRD의 사용자 시나리오와 요구사항. 건너뛰기 신청과 취소를 글머리표 문장으로 적음
스킬 없이 1번째 PRD의 요구사항. 건너뛰기 신청과 취소를 줄글 목록으로 적음 · Claude Code · 소넷 5.5 · 생각 깊이 중간

스킬을 부른 2번은 요구사항을 P0·P1·P2 세 단계로 나누고, P0 항목마다 완성 기준을 붙였습니다. 형식은 “Given(이런 상황에서) / When(이렇게 하면) / Then(이렇게 된다)”과 체크 목록입니다. 예를 들어 결제 연동 항목에는 “결제 대행사 호출이 실패하면 건너뛰기를 접수된 것으로 처리하지 않는다”, “마감 뒤에는 호출을 시도하지 않는다”가 들어 있습니다. 개발자가 이 문장을 그대로 시험 항목으로 쓸 수 있습니다.

write-spec 스킬 2번째 PRD의 P0 요구사항 R1~R4. 항목마다 Given·When·Then과 체크 목록이 붙어 있음
스킬 2번째 PRD의 P0 요구사항. 항목마다 Given·When·Then과 체크 목록 · Claude Code · 소넷 5.5 · 생각 깊이 중간

두 번째 차이는 성공 지표입니다. 4번 모두 목표 숫자와 재는 방법을 표로 냈습니다. 스킬 쪽만 지표를 출시 뒤 1~4주에 볼 선행 지표와 1~3개월에 볼 후행 지표로 나눴습니다. 대표가 원한 “해지가 얼마나 줄었나”는 몇 달 뒤에야 보이는 숫자입니다. 선행 지표가 따로 있으면 그 전에 카톡 수작업 요청과 잘못 결제된 건수부터 확인할 수 있습니다.

write-spec 스킬 2번째 PRD의 성공 지표. 출시 후 1~4주 선행 지표 표와 1~3개월 후행 지표 표
스킬 2번째 PRD의 성공 지표. 선행 지표와 후행 지표를 나누고 성공·스트레치 목표를 적음 · Claude Code · 소넷 5.5 · 생각 깊이 중간

세 번째 차이는 열린 질문입니다. 스킬 없이 받은 2번은 못 정한 3개와 임시값을 한 목록에 모았습니다. 스킬 쪽은 질문마다 답할 사람(대표·운영·개발)을 적고, 시작 전에 꼭 정할 질문 3개와 만들면서 정해도 되는 질문을 나눴습니다. 질문 수는 7개와 9개였습니다.

write-spec 스킬 2번째 PRD의 열린 질문. 차단성 3개와 비차단성 6개를 담당·임시 결정과 함께 적은 표
스킬 2번째 PRD의 열린 질문. 차단성·비차단성으로 나누고 질문마다 담당과 임시 결정을 적음 · Claude Code · 소넷 5.5 · 생각 깊이 중간

스킬 쪽 2번은 “~로서, ~하길 원한다” 꼴의 사용자 스토리도 9개씩 넣었습니다. 구독자, 운영 담당, 대표 세 역할로 나눴고 마감이 지난 구독자의 스토리도 있습니다.

스킬 쪽이 더 못한 곳도 있습니다. 스킬 1번째는 목표를 6개 적어서 안내문의 “3~5개”를 넘겼습니다. 스킬 쪽 문서에는 “Given/When/Then”, “stretch”, “Open Questions” 같은 영어 낱말이 섞여 나옵니다.

복사해 쓰는 요청문과 실습 자료

아래 요청문을 그대로 썼습니다. 스킬 조건에서는 맨 앞에 /product-management:write-spec을 붙였습니다.

'배송 건너뛰기' 기능 PRD(기획서)를 써 줘. 이 폴더의 회의_메모.txt, 해지_사유.csv, 고객_문의.txt를 보고 써서 PRD.md 파일로 저장해 줘. 지금은 더 답해 줄 사람이 없으니 자료만 보고 써 줘.

내 일에 쓸 때는 기능 이름과 파일 이름만 바꿉니다. 물어볼 사람이 있으면 마지막 문장을 빼고 대화로 진행합니다. 스킬 안내문은 그 경우 문제, 대상 사용자, 성공 지표, 제약을 중요한 것부터 몇 개씩 묻고 나서 쓰도록 되어 있습니다. 이번에는 답해 줄 사람이 없는 조건으로만 해 봤습니다.

실습 자료 내려받기(prd-practice.zip): 회의 메모, 해지 사유, 고객 문의, 요청문, 채점 기준을 넣었습니다. 좋은 답이라면 건너뛰기 마감을 일요일 오전 9시나 그 전으로 잡고, 메뉴 바꾸기·선물하기·포인트 적립을 이번 범위에서 뺍니다.

1단계. 플러그인 넣기 (약 1분)

이 단계에서는 클로드 코드가 write-spec 안내문을 읽을 수 있게 합니다. 플러그인 README에 적힌 설치 명령은 터미널에서 아래 두 줄입니다. 이 설치 명령은 이번에 실행하지 않았고, 이 부분은 공식 문서 기준입니다.

claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install product-management@knowledge-work-plugins

설치하지 않고 한 번만 써 보려면 저장소를 내려받아 --plugin-dir로 플러그인 폴더를 가리킵니다. 플러그인이 그 실행에만 붙습니다. 이번 실험은 플러그인 폴더 사본에 이 옵션을 써서 했습니다.

git clone https://github.com/anthropics/knowledge-work-plugins
claude --plugin-dir knowledge-work-plugins/product-management

이렇게 나오면 성공 이번 실행에서는 스킬 2번 모두 명령 목록에 product-management:write-spec이 올라왔고, 세션 기록에 안내문의 요구사항 분류와 범위 관리 항목이 들어간 것을 확인했습니다.

  • command not found: claude가 나오면 터미널을 닫았다 다시 열고 claude --version을 먼저 확인합니다.
  • 필요 없어지면 claude plugin uninstall product-management@knowledge-work-plugins로 지웁니다.
  • 플러그인에는 슬랙·노션·리니어 같은 외부 연결 설정도 들어 있습니다. 이번에는 연결하지 않고 폴더 속 파일만으로 했습니다.

플러그인에는 write-spec 말고도 스킬이 7개 더 있습니다. 아래 설명은 각 스킬 안내문의 소개 문장 기준입니다. 이 가운데 synthesize-research는 기획 플러그인 리뷰에서 써 봤습니다.

스킬하는 일(공식 설명 기준)
write-spec아이디어나 문제 설명으로 기능 명세·PRD 쓰기
synthesize-research인터뷰·설문·문의를 주제별로 묶어 정리
roadmap-update로드맵을 만들거나 우선순위를 다시 정하기
stakeholder-update읽는 사람(경영진·개발팀 등)에 맞춘 진행 상황 보고
competitive-brief경쟁사 비교 자료 만들기
metrics-review제품 지표의 추세와 목표 대비 점검
sprint-planning스프린트 범위와 인원 여유 계산
product-brainstorming아이디어를 넓히고 가정을 따져 보는 대화 상대

2단계. 회의 메모로 PRD 받기 (약 1분)

이 단계에서는 메모와 자료 파일로 PRD를 받습니다. 자료를 넣은 폴더에서 터미널로 claude를 켜고 위 요청문을 붙여 넣습니다. 채점 기준 10개는 실행 전에 스킬 안내문의 PRD 구성과 조언에서 뽑아 정해 두었습니다.

이렇게 나오면 성공 폴더에 “PRD.md”가 생기고, 문제 정의에 해지 150건 중 54건이라는 근거 숫자가 들어 있습니다. 4번 모두 1분에서 1분 반 사이에 끝났습니다.

  • 스킬 없이 쓸 때 완성 기준이 없으면: “필수 요구사항마다 어떻게 되면 완성인지 체크 목록으로 붙여 줘”라고 한 줄 더 요청해 볼 수 있습니다. 이번에는 이 요청을 해 보지 않았습니다.
  • 영어 낱말이 거슬리면: “Given/When/Then과 영어 제목을 한국어로 바꿔 줘”라고 요청합니다.
  • 날짜와 요일은 달력으로 다시 확인합니다. 스킬 없이 받은 1번째는 화요일인 2026년 12월 15일을 월요일이라고 적었습니다.
채점 항목없이 1없이 2스킬 1스킬 2
문제 정의에 근거 숫자(150건 중 54건)OOOO
목표 3~5개, 잴 수 있는 결과OOXO
비목표에 메뉴·선물·포인트와 이유OOOO
사용자 스토리(역할 둘 이상, 예외 포함)XXOO
요구사항을 세 단계 이상으로 구분XXOO
필수 요구사항마다 완성 기준XXOO
지표를 선행·후행으로 나누고 목표·시점XXOO
열린 질문에 담당과 차단 여부XXOO
일정: 12월 15일, 외부 의존, 단계OOOO
마감을 일요일 오전 9시 이전으로OOOO
합계55910

실행 기록 · <작업 폴더>/tools/run.sh, <작업 폴더>/runs.tsv

# 같은 요청문. 스킬 조건은 --plugin-dir·--add-dir과 맨 앞 /product-management:write-spec
claude -p "$(cat tools/request.txt)" --model claude-sonnet-5-5 --effort medium \
  --setting-sources project,local --permission-mode acceptEdits [--plugin-dir skill/product-management --add-dir skill/product-management] \
  --allowedTools "Bash(ls:*),Bash(python3:*),Read,Write,Edit,Skill,Glob,Grep" --disallowedTools "WebSearch,WebFetch" --output-format stream-json --verbose

조건	회차	불린 스킬	걸린 시간	사용량(API 단가)	턴	채점
스킬 없이	1	없음	61초	0.30달러	3	5/10
스킬 없이	2	없음	76초	0.33달러	3	5/10
스킬	1	/product-management:write-spec	86초	0.37달러	3	9/10
스킬	2	/product-management:write-spec	79초	0.36달러	3	10/10

이런 사람에게 권합니다

  • ✅ PRD를 처음 써 보는 기획자·창업자. 여덟 칸이 빠짐없이 채워져 나와서 틀을 따로 찾지 않아도 됩니다.
  • ✅ 개발자에게 문서를 넘겨야 하는 사람. 필수 요구사항마다 완성 기준이 붙어 있어 “다 됐다”의 뜻을 두고 다시 묻는 일이 줄어듭니다.
  • ❌ 범위 정하기와 빠진 조건 찾기만 필요한 사람. 이 부분은 스킬 없이도 결과가 같았습니다.

한계와 주의할 점

  • 조건마다 2번씩, 지어낸 서비스 자료로 해 본 결과입니다. 점수 차이가 스킬 때문인지 우연인지는 이 횟수로 가릴 수 없습니다.
  • 채점 기준 10개를 스킬 안내문에서 뽑았기 때문에 스킬 쪽이 유리한 구조입니다. 벌어진 5개 항목은 모두 문서의 형식에 관한 것입니다.
  • 목표 숫자(해지 절반, 수작업 주 4~5건 이하)와 연속 2주 한도는 클로드가 단 임시값입니다. 자료에 근거가 없으므로 사람이 정해야 합니다.
  • 외부 연결 없이 폴더 속 파일만으로 했습니다. 안내문에는 프로젝트 관리 도구나 문서 도구가 연결돼 있으면 관련 티켓과 예전 명세를 찾아 온다고 적혀 있습니다. 이 부분은 써 보지 않았습니다.

대안

이름다른 점이럴 때 고르세요
클로드 코드에 요청만설치 없음. 범위 정하기와 빠진 조건 찾기는 같게 나오지만 문서 꼴은 그때그때 다름혼자 보고 판단할 초안이 필요할 때
write-spec(이 글)PRD 여덟 칸, 우선순위 세 단계, 항목별 완성 기준, 담당이 붙은 열린 질문개발자·대표와 같이 볼 문서가 필요할 때
doc-coauthoring 스킬질문을 주고받으며 문서를 같이 써 나감자료가 없고 머릿속 생각부터 꺼내야 할 때
스펙킷(Spec Kit)명세에서 계획·작업 목록·코드까지 이어 감PRD를 쓴 뒤 클로드 코드로 바로 개발할 때

자주 묻는 질문

PRD와 기획서는 다른가요?

기획서는 넓은 말입니다. 사업 기획서, 행사 기획서처럼 여러 문서를 가리킵니다. PRD는 그 가운데 제품이나 기능 하나의 요구사항을 적는 문서입니다. 화면 설계서(스토리보드)는 보통 PRD가 정한 범위를 화면으로 옮기는 다음 단계 문서입니다.

PRD 양식이 따로 있나요?

정해진 표준은 없습니다. 회사마다 칸이 조금씩 다릅니다. 이 글의 여덟 칸은 write-spec 스킬 안내문이 쓰는 구성입니다. 스킬 2번째 결과를 그대로 열어 틀로 삼아도 됩니다.

회의 메모 없이 한 줄 아이디어만 줘도 되나요?

안내문에는 기능 이름, 문제 설명, 사용자 요청, 막연한 아이디어 어느 것으로도 시작할 수 있다고 적혀 있습니다. 그 경우 클로드가 질문을 먼저 합니다. 이번에는 자료 파일을 준 경우만 해 봤습니다.

출처

anthropics/knowledge-work-plugins 저장소, Product Management 플러그인, write-spec SKILL.md (2026-11-12 확인)