---
description: AI 에이전트가 이해하기 쉬운 PRD 작성 가이드
---

# AI 친화적인 PRD 작성법

AI 에이전트(예: Antigravity, Cursor)가 프로젝트를 정확하게 이해하고 구현할 수 있도록 PRD를 작성하는 방법입니다.

## 1. 필수 구성 요소

### 1.1 프로젝트 개요
- **목적**: 프로젝트가 해결하려는 문제와 목표를 명확히 기술합니다.
- **타겟 사용자**: 누가 이 기능을 사용하는지 명시합니다.

### 1.2 핵심 워크플로우 (User Stories)
- 사용자가 시스템과 상호작용하는 구체적인 흐름을 단계별로 작성합니다.
- 예: "사용자가 로그인 버튼을 클릭하면 -> 구글 로그인 창이 뜨고 -> 성공 시 대시보드로 이동한다."

### 1.3 기능 요구사항 (Functional Requirements)
- **계층 구조 유지**: `### 메인 태스크` -> `#### 서브 태스크` 구조를 반드시 지킵니다.
- **우선순위 명시**: 각 기능에 `🔴 필수`, `🟡 권장`, `🟢 선택` 중 하나를 명시합니다.
- **완료 기준 (Acceptance Criteria)**:
    - 체크박스(`- [ ]`) 형태로 구체적인 검증 항목을 나열합니다.
    - AI는 이 기준을 바탕으로 구현 여부를 판단합니다.

### 1.4 기술적 제약 사항 (Constraints)
- 사용할 기술 스택 (예: Next.js 14, TailwindCSS, Supabase)
- 데이터베이스 스키마 설계 (ERD 또는 테이블 명세)
- 디렉토리 구조 (예: `src/features/...` 사용 필수 등)

## 2. 작성 팁

- **중의적 표현 피하기**: "적절하게", "빠르게", "예쁘게" 등의 모호한 표현 대신 "1초 이내 로딩", "Primary Color(#000000) 사용" 등 구체적으로 작성하세요.
- **파일 경로 명시**: 수정해야 할 핵심 파일이나 참조할 파일 경로를 명시하면 AI가 탐색 시간을 줄일 수 있습니다.
- **예외 상황 고려**: "로그인 실패 시", "네트워크 에러 시" 등의 케이스를 포함하세요.

## 3. 포맷 예시

```markdown
# [프로젝트명] PRD

## 1. 프로젝트 개요
...

## 2. 유저 플로우
...

## 3. 기능 요구사항 (필수)

### 3.1 사용자 인증
- **우선순위**: 🔴 필수
- **설명**: 이메일 및 소셜 로그인 기능을 구현합니다.
- **완료 기준**:
  - [ ] 이메일 정규식 검증 적용
  - [ ] 로그인 성공 시 JWT 토큰 발급 확인
  - [ ] 로그아웃 시 토큰 삭제 확인

#### 3.1.1 로그인 UI 구현
...
```