PRD란?
PRD(Product Requirements Document)는 제품을 만들거나 업데이트하기 위해 기능을 기획하는 단계에서 요구사항을 개괄적으로 설명하는 문서로, 제품 개발 프로세스 전반에 걸쳐 필수적인 중요 문서를 의미한다.
일반적으로 PRD를 작성하면 개발팀 및 이해관계자에게 공유하고 제품 개발 프로세스에 참여하는 모든 사람이 제품의 요구 사항을 확인하고 개발 하는데 있어 큰 도움이 된다.
이 PRD를 AI가 수행 해야할 JOB을 명시 해주는 목적으로 사용하게 된다면, 충분히 vibe에 가깝게 코드 수행 해주는 것을 볼 수 있었다.
이번 글에서는 간략하게 어떻게 클로드 코드를 통해서 PRD를 작성 해야 하는지에 대해서 알아보고자 한다.
PRD를 이용한 Claude Code 활용법
먼저 클로드 코드를 사용하여 무언가를 개발 할 때는 /init 부터 진행 하여서 CLAUDE.md를 자동 생성 하여 프로젝트 룰을 지정 해준다.
클로드 코드는 프로젝트 루트에 CLAUDE.md가 있으면 이를 기본적으로 참조하여 명령들을 수행 하기에 우리가 프로젝트에서의 룰이나 컨벤션 등을 명시 해줄 수 있다.
그 다음으로는 우리가 클로드 코드에게 구현을 시키고자 하는 기능들에 대해서 명세를 해주기 위해서 PRD를 작성 해야 한다.
이 때 PRD를 직접 작성을 해야 하나?
아니다. 위 PRD 또한 클로드에게 맡기면 된다.
물론 도메인 및 구현 요구사항이 어렵거나 팀에 PRD를 작성 해주는 다른 기획자 등의 인물이 있다면 PRD를 요청 하여 전달 받는 것도 좋은 방법이다.
만약 그런 여건이 안되거나 간단하고 빠르게 기능을 구현을 해야 하는 경우에는 단순히 클로드 코드에게 아래와 같이 원하는 기능에 대해서 간략하게 설명을 해도 되고, 구조화된 프롬프트를 사용하여 질의 하면 더 체계적이고 완성도 높은 결과를 얻을 수 있다.
Plan 모드를 사용하면 내가 현재 의도한 바대로 클로드 코드가 작성하는지에 대해서 내가 주도적으로 확인 및 검증을 할 수 있어 추천하는 방식이다.
먼저 간략하게 설명 했을 때는 다음과 같이 클로드 코드가 본인 스스로 템플릿을 구축해 답변을 한다.
그러나 내가 원하는 PRD 템플릿이 있거나, 구현을 원하는 명확한 기능 명세가 있다면 다음과 같이 구조화된 프롬프트를 통해서 더욱 내가 원하는 PRD를 클로드 코드가 작성할 수 있게 할 수 있다.
이렇게 구체적이고, 명확한 예시를 전달한 프롬프트는 사람에게도 적용 되듯이 지시자가 바라는 내용과 일치 해 갈 확률이 높아진다.
이렇게 클로드코드가 아래와 같이 PRD를 작성 해주었다고 하자.
.prd/feat-user-auth.md
그러면 이제 클로드 코드에게 feat-user-auth.md 의 PRD를 단계별로 수행 달라고 지시 하면 된다.
이 때도 plan 모드를 사용하면 단계별로 구현하는데 있어서 더욱 효과적으로 기능 구현을 할 수 있다.
그리고 각 단계의 시작과 끝 마다 적절한 서브 에이전트를 사용해달라고 하는 것도 구현에 있어서 큰 도움이 되는 것 같다.
나는 일반적으로 소스 코드의 성능과 안정성, 유지보수성을 판단하여 설계 하는 시니어 백엔드 개발자 Agent와 Playwright MCP를 사용한 통합 테스터 Agent 등을 사용 하고 있기에 이러한 서브 에이전트의 사용은 큰 도움이 된다.
다음 글로는 내가 어떤 서브 Agents 등을 사용하고 있는지를 공유 하는 시간을 가지고자 한다.
