배포 Skill

release 브랜치에 main 반영, 빌드 검증 통과 후 push, Vercel 자동 배포 트리거.

배포 플로우 개요

1. 사전 상태 점검
2. release 브랜치 체크아웃 및 main 반영
3. 빌드 검증 (pnpm build)
4. push (Vercel 자동 배포 트리거)
5. 원래 브랜치로 복귀

실행 순서

1. 사전 상태 점검

아래 명령으로 현재 상태 확인:

git status --porcelain
git rev-parse --abbrev-ref HEAD

중단 조건:

• working tree dirty 상태면 중단, 사용자에게 커밋/스태시 요청
• 현재 브랜치 변수 저장 (작업 후 복귀용)

origin/main과 origin/release 최신화:

git fetch origin main release --prune

2. release 브랜치 체크아웃 및 main 반영

git checkout release
git pull --ff-only origin release
git merge origin/main --no-edit

주의:

• --ff-only 실패 시 원격 release와 로컬 divergence → 사용자 확인 필수
• merge conflict 발생 시 즉시 중단 및 사용자 알림 (자동으로 git merge --abort 실행 후 원래 브랜치로 복귀)

3. 빌드 검증

pnpm build로 프로덕션 빌드 검증. (빌드는 장시간 실행 가능 작업이므로 run_in_background 사용을 고려)

pnpm build

실패 시:

• push하지 않음
• merge 커밋을 되돌릴지 사용자에게 확인 (되돌림: git reset --hard origin/release)
• 원래 브랜치로 복귀 후 종료

4. push (Vercel 자동 배포)

빌드 성공 시에만 push:

git push origin release

push 성공 후 Vercel 자동 배포 시작.

5. 원래 브랜치로 복귀

1단계에서 기억해둔 원래 브랜치로 복귀:

git checkout <원래 브랜치>

금지 사항

• --no-verify, --force, --force-with-lease 사용 금지
• 빌드 실패 시 push 절대 금지
• merge conflict 자동 해결 금지 → 반드시 사용자에게 위임
• release 브랜치에 직접 커밋 추가 금지 (main merge만 허용)

확장 포인트 (추후 추가)

CI/CD 인프라 확장 시 스킬 내부 통합 후보.

• 배포 전 lint/type-check 통합 (pnpm lint)
• 버전 태그 자동 생성 (git tag v0.x.y)
• 배포 후 smoke test (대상 URL heartbeat 체크)
• Slack/Discord 배포 알림 hook
• 체인지로그 생성 및 GitHub Release 연동