api-handofflisted

# API Handoff 프론트엔드-백엔드 간 API 핸드오프 문서 생성. 양방향 지원. ## 모드 선택 | 모드 | 용도 | 트리거 | |------|------|--------| | **Backend → Frontend** | API 완성 후 프론트 전달 | "create handoff", "document API", "frontend handoff" | | **Frontend → Backend** | 데이터 요구사항 전달 | "backend requirements", "what data do I need" | --- ## Mode 1: Backend → Frontend Handoff > **No Chat Output**: 핸드오프 문서만 생성. 설명 없음. 백엔드 개발 완료 후 프론트엔드에 전달하는 구조화된 문서 생성. ### Workflow 1. **Collect context** — feature, endpoints, DTOs, auth, edge cases 확인 2. **Create handoff file** — `docs/ai/<feature-name>/api-handoff.md` 3. **Fill template** — 모든 섹션 작성 4. **Double-check** — 페이로드, auth, validation 검증 ### Output Template ```markdown # API Handoff: [Feature Name] ## Business Context [2-4 sentences: 문제, 사용자, 중요성, 도메인 용어] ## Endpoints ### [METHOD] /path/to/endpoint - **Purpose**: [1줄] - **Auth**: [role/permission 또는 "public"] - **Request**: ```json { "field": "type — description, constraints" } ``` - **Response** (success): ```json { "field": "type — description" } ``` - **Response** (error): [HTTP codes: 422, 404 등] - **Notes**: [edge cases, rate limits, pagination] ## Data Models / DTOs [TypeScript interface 형식] ## Enums & Constants | Value | Meaning | Display Label | |-------|---------|---------------| ## Validation Rules [프론트가 미러링할 검증 규칙] ## Business Logic & Edge Cases - [비자명한 동작, 제약조건] ## Integration Notes - **Recommended flow**: [fetch → select → submit → poll] - **Optimistic UI**: [safe 여부] - **Caching**: [