Vercel 배포 도우미

## 누구를 위한 도구인가

Vercel 에 Next.js 앱을 배포하는 프론트엔드 개발자와 인디 해커를 위해 만들어졌습니다. 이 플러그인은 베스트 프랙티스 적용과 환경 변수 관리부터 배포 트리거와 상태 모니터링까지 전체 배포 라이프사이클을 처리합니다 — 모든 작업이 채팅에서 이루어집니다.

## 3 단계 빠른 시작 가이드

1. **배포 전 검토** — 이렇게 물어보세요: `"Use next-best-practices to review my Next.js app structure and flag any issues before deploying"`. 이 스킬은 Server Components 사용법, 데이터 페칭 패턴, 파일 컨벤션을 확인합니다.
2. **배포** — 이렇게 물어보세요: `"Use vercel-deployment to deploy my project at ~/Projects/myapp to production"`. 이 스킬은 환경 변수 검증을 포함한 Vercel CLI 흐름을 처리합니다.
3. **배포 관리** — 이렇게 물어보세요: `"Use vercel-automation to list my last 5 deployments and show the status of each"`. 이 스킬은 롤백, DNS 관리, 환경 변수 업데이트도 가능합니다.

## 단계 → 스킬 → 입력 → 출력

| 단계 | 스킬 | 제공 항목 | 결과 |
|------|-------|------------------|--------------|
| 배포 전 검토 | next-best-practices | 프로젝트 디렉토리 또는 코드 스니펫 | 문제 목록 + 베스트 프랙티스 권장사항 |
| 배포 | vercel-deployment | 프로젝트 경로 + 대상 환경 | 배포 URL + 빌드 로그 요약 |
| 배포 후 관리 | vercel-automation | 프로젝트 이름 + 작업 (list/rollback/dns) | 배포 목록, 상태, 또는 확인 메시지 |

## 일반적인 오류 및 해결 방법

- **vercel-deployment 이 "not logged in" 오류로 실패함** → 먼저 터미널에서 `vercel login` 을 실행하거나 `VERCEL_TOKEN` 환경 변수를 제공하세요.
- **next-best-practices 가 Server Component 문제를 플래그함** → 출력된 수정 제안을 따르세요. 일반적인 해결책: `"use client"` 를 가능한 가장 작은 서브트리로 이동합니다.
- **vercel-automation 이 프로젝트를 찾을 수 없음** → Vercel 에서 프로젝트 이름은 대소문자를 구분합니다. Vercel 대시보드에서 정확한 이름을 확인하세요.

## 성공 기준

다음과 같은 경우 성공한 것입니다:
- next-best-practices 가 모든 중요 항목을 녹색으로 표시한 체크리스트를 반환합니다
- vercel-deployment 가 실제 `.vercel.app` URL 을 반환합니다
- vercel-automation 이 정확한 타임스탬프와 상태로 배포를 나열합니다