AI Agent에게 개발을 맡길 때 PRD를 먼저 작성해야 하는 이유

Summary

생성형 AI 시대가 도래하면서 누구나 코딩할 수 있는 시대가 열렸다고들 말한다. 하지만 실제로 AI Agent를 활용해 조금만 복잡한 제품을 만들어보면, 단순한 지시만으로는 좋은 결과를 얻기 어렵다는 것을 빠르게 알게 된다.

문제

"로그인 기능을 만들어줘"라는 단순한 프롬프트는 재작업의 시작이 되기 쉽다. AI는 구글 소셜 로그인을 원하는지, 이메일과 비밀번호 방식을 원하는지, 비밀번호 초기화는 어떻게 처리할지 알 수 없다.

AI는 훌륭한 타이피스트이자 주니어 개발자일 수 있지만, 기획자는 아니다. 무엇을 만들지 정의하는 것은 여전히 인간의 몫이다.

결국 생성된 코드를 보고 나서야 "이게 아니었는데"라고 말하게 되고, 다시 프롬프트를 수정하고, 다시 코드를 받고, 또 수정하는 반복이 생긴다.

해결 방법

이 문제를 줄이는 가장 현실적인 방법은 PRD(Product Requirements Document)를 먼저 작성하는 것이다. 단, 인간 개발자를 위한 긴 문서가 아니라 AI Agent가 바로 구현 맥락으로 사용할 수 있는 짧고 구조적인 PRD가 좋다.

# AI Agent를 위한 미니 PRD 구조

1. Product Overview: 무엇을, 왜 만드는가?
2. Target Audience: 누가 사용하는가?
3. Key Features:
   - [P0] 필수 기능 목록 및 작동 방식
   - [P1] 부가 기능
4. Tech Stack Constraints:
   - Frontend: Next.js App Router
   - Styling: Tailwind or CSS modules
5. Edge Cases & Error Handling: 예외 상황 처리

이렇게 구조화된 문서를 컨텍스트로 제공하면 AI는 전체 아키텍처를 고려해 더 일관성 있는 코드를 작성한다.

구현

AI Agent에게 맡길 작업을 작게 나누는 것도 중요하다. "블로그 만들어줘"보다 "App Router로 글 목록과 상세 페이지를 만들고, 마크다운 frontmatter에서 metadata를 생성해줘"가 훨씬 정확한 결과를 만든다.

단계

• 사이트 구조와 URL을 먼저 정한다.
• 콘텐츠 저장 방식을 먼저 정한다.
• 생성할 페이지와 컴포넌트 책임을 분리한다.
• 완료 조건을 테스트 가능한 문장으로 쓴다.

결과

PRD가 있으면 AI는 의도를 추측하는 대신 문서에 있는 제약을 따라간다. 수정 횟수도 줄고, 사람이 리뷰해야 할 범위도 명확해진다.

결론

AI가 코딩을 대신해주는 시대에 개발자의 역할은 코더에서 아키텍트이자 기획자로 이동하고 있다. 코드를 직접 많이 치는 능력만큼, 풀고자 하는 문제를 명확하게 정의하는 능력이 중요해졌다.

References

• Next.js Documentation
• React Server Components