Dannykkh Shipping & Launch — 출시 체크리스트 + 단계적 롤아웃
"빨리 배포하되, 안전하게 배포하라." 배포는 코드 완성이 아니라 사용자에게 가치가 전달되는 순간이다.
Quick Start
/launch # 전체 프리런치 체크리스트 실행
/launch --scope backend # 백엔드만 체크
/launch --scope frontend # 프론트엔드만 체크
/launch --rollout # 단계적 롤아웃 계획 생성
/launch --rollback # 롤백 플레이북 생성
/launch --dry-run # 체크만 (변경 없음)
공식 호출명: /launch (별칭: 런치, 출시, go-live, 배포 준비)
적용 시점
| 상황 | 적용 |
|---|---|
| 새 기능/서비스 첫 배포 | O |
| 대규모 마이그레이션 후 go-live | O |
| API 버전 전환 | O |
| 인프라 변경 (DB, 캐시, CDN) | O |
| 일상적인 버그 수정 배포 | X — /release로 충분 |
| 개발 환경 변경 | X |
CRITICAL: First Actions
1. Print Intro
Shipping & Launch — 출시 체크리스트
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
순서: Scope → Pre-Launch → Launch Plan → Rollback → Post-Launch
2. 배포 스코프 감지
# 변경 범위 파악
_BASE=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||' || echo "main")
_CHANGED=$(git diff origin/$_BASE --name-only 2>/dev/null || git diff HEAD~10 --name-only)
# 영역 분류
_HAS_BACKEND=false; _HAS_FRONTEND=false; _HAS_INFRA=false
_HAS_DB=false; _HAS_API=false; _HAS_AUTH=false; _HAS_DEPS=false
echo "$_CHANGED" | grep -qiE '\.(py|rb|java|go|cs|rs|kt|php)$' && _HAS_BACKEND=true
echo "$_CHANGED" | grep -qiE '\.(tsx?|jsx?|vue|svelte|css|scss)$' && _HAS_FRONTEND=true
echo "$_CHANGED" | grep -qiE '(docker|k8s|terraform|helm|nginx|Caddyfile)' && _HAS_INFRA=true
echo "$_CHANGED" | grep -qiE '(migrat|schema|alembic|flyway|prisma)' && _HAS_DB=true
echo "$_CHANGED" | grep -qiE '(openapi|swagger|\.proto|graphql)' && _HAS_API=true
echo "$_CHANGED" | grep -qiE '(auth|login|session|token|oauth|jwt)' && _HAS_AUTH=true
echo "$_CHANGED" | grep -qiE '(package\.json|requirements|go\.mod|Cargo|\.csproj)' && _HAS_DEPS=true
echo "SCOPE: backend=$_HAS_BACKEND frontend=$_HAS_FRONTEND infra=$_HAS_INFRA"
echo " db=$_HAS_DB api=$_HAS_API auth=$_HAS_AUTH deps=$_HAS_DEPS"
Step 1: Pre-Launch 체크리스트
1.1 코드 품질 게이트
| # | 항목 | 확인 방법 | 필수 |
|---|---|---|---|
| 1 | 모든 테스트 통과 | npm test / pytest / go test |
필수 |
| 2 | 타입 체크 통과 | tsc --noEmit / mypy / etc. |
필수 |
| 3 | 린트 통과 | eslint / ruff / golangci-lint |
필수 |
| 4 | 코드 리뷰 완료 | PR approved | 필수 |
| 5 | 보안 스캔 | npm audit / pip audit / SAST |
권장 |
| 6 | 번들 사이즈 확인 | 이전 대비 증가량 | 프론트엔드 |
| 7 | 성능 테스트 | 부하 테스트 / 벤치마크 | 대규모 변경 시 |
1.2 인프라/환경 체크
| # | 항목 | 확인 사항 |
|---|---|---|
| 1 | 환경 변수 | 새 env var가 프로덕션에 설정되었는가? |
| 2 | 시크릿 | 새 시크릿이 시크릿 매니저에 등록되었는가? |
| 3 | DB 마이그레이션 | 마이그레이션이 롤백 가능한가? |
| 4 | 외부 의존성 | 새 API 키, 서드파티 서비스 준비 완료? |
| 5 | DNS/도메인 | 새 도메인/서브도메인 설정 완료? |
| 6 | SSL/TLS | 인증서 유효? 자동 갱신 설정? |
| 7 | CDN/캐시 | 캐시 무효화 계획? |
1.3 모니터링/관측성 체크
| # | 항목 | 확인 사항 |
|---|---|---|
| 1 | 로깅 | 핵심 경로에 로그 있는가? |
| 2 | 메트릭 | 비즈니스 메트릭 대시보드 준비? |
| 3 | 알림 | 에러율/지연시간 알림 설정? |
| 4 | 헬스체크 | /health 엔드포인트 존재? |
| 5 | APM | 트레이싱 설정 (Datadog, Sentry 등)? |
1.4 사용자 경험 체크 (프론트엔드)
| # | 항목 | 확인 사항 |
|---|---|---|
| 1 | 크로스 브라우저 | Chrome, Firefox, Safari, Edge |
| 2 | 모바일 반응형 | 320px ~ 1440px |
| 3 | 접근성 | 키보드 네비게이션, 스크린 리더 |
| 4 | 에러 상태 | 네트워크 오류, 빈 상태, 로딩 상태 |
| 5 | SEO | 메타 태그, OG 태그, sitemap |
Step 2: 단계적 롤아웃 계획
롤아웃 단계 템플릿
# Rollout Plan: {기능/서비스명}
## Phase 1: Internal (Day 0)
- **대상**: 내부 팀 / 스테이징
- **비율**: 0% 외부 트래픽
- **기간**: 1-2일
- **성공 기준**: 에러율 < 0.1%, 지연시간 기존 대비 ±10%
- **모니터링**: 15분 간격 대시보드 확인
## Phase 2: Canary (Day 1-3)
- **대상**: 1-5% 프로덕션 트래픽
- **기간**: 1-3일
- **성공 기준**: 에러율 < 0.5%, P99 지연시간 < {N}ms
- **자동 롤백**: 에러율 > 1% 시 자동 롤백
- **모니터링**: 5분 간격
## Phase 3: Gradual (Day 3-7)
- **대상**: 10% → 25% → 50% 순차 확대
- **기간**: 3-5일
- **성공 기준**: 비즈니스 메트릭 이상 없음
- **확대 조건**: 24시간 안정 시 다음 단계
## Phase 4: Full (Day 7+)
- **대상**: 100% 트래픽
- **조건**: Phase 3 성공 기준 48시간 유지
- **이후**: 피처 플래그 정리, 레거시 코드 제거 계획
피처 플래그 체크
# 피처 플래그 사용 확인
grep -rn "feature_flag\|featureFlag\|FEATURE_\|isEnabled\|unleash\|launchdarkly\|growthbook" \
--include="*.{ts,tsx,js,jsx,py,java,go,rb}" . 2>/dev/null | head -20
Step 3: 롤백 플레이북
롤백 플레이북 템플릿
# Rollback Playbook: {기능/서비스명}
## 롤백 트리거 조건
- [ ] 에러율 > {N}% (5분 이상 지속)
- [ ] P99 지연시간 > {N}ms (10분 이상 지속)
- [ ] 핵심 비즈니스 흐름 실패 (결제, 로그인 등)
- [ ] 데이터 무결성 이슈 발견
## 즉시 롤백 절차
### 애플리케이션 롤백
```sh
# 이전 버전으로 롤백
git revert HEAD # git
kubectl rollout undo deployment/{name} # k8s
aws ecs update-service --force-new-deployment # ECS
DB 마이그레이션 롤백
# 마이그레이션 되돌리기 (가능한 경우)
npx prisma migrate resolve --rolled-back {migration} # Prisma
alembic downgrade -1 # Alembic
flyway undo # Flyway
피처 플래그 킬스위치
# 피처 플래그로 즉시 비활성화 (코드 롤백 불필요)
curl -X PATCH {flag-service}/api/flags/{flag-name} \
-d '{"enabled": false}'
롤백 후 확인
- 에러율 정상 복귀
- 지연시간 정상 복귀
- 사용자 신고 없음
- 포스트모텀 일정 잡기
---
## Step 4: Post-Launch 체크리스트
| 시점 | 항목 | 확인 사항 |
|------|------|-----------|
| **+1시간** | 에러율 | 정상 범위 내 |
| | 지연시간 | P50, P99 확인 |
| | 로그 | 새로운 에러 패턴 없음 |
| **+24시간** | 비즈니스 메트릭 | 전환율, 이탈률 이상 없음 |
| | 사용자 피드백 | CS 문의 증가 여부 |
| | 리소스 사용량 | CPU, 메모리, 디스크 |
| **+1주** | 안정성 확인 | 에러 트렌드 분석 |
| | 피처 플래그 정리 | 불필요한 플래그 제거 |
| | 문서 업데이트 | 운영 문서, API 문서 |
| | 포스트모텀 | 이슈 있었으면 회고 작성 |
---
## Step 5: 최종 출력
Launch 체크리스트 완료 ━━━━━━━━━━━━━━━━━━━━━━ 스코프: backend + frontend + db-migration
Pre-Launch: [PASS] 코드 품질 게이트 (8/8 통과) [PASS] 인프라/환경 체크 (7/7 확인) [WARN] 모니터링 체크 (4/5 — APM 미설정) [PASS] 사용자 경험 체크 (5/5 확인)
생성된 산출물: - docs/rollout-plan-{feature}.md (롤아웃 계획) - docs/rollback-playbook-{feature}.md (롤백 플레이북)
판정: GO (경고 1건 — APM 설정 권장)
다음 단계: 1. APM 설정 (권장) 2. /release로 버전 태그 3. 배포 실행 4. Post-Launch +1시간 체크
---
## Red Flags — 위험한 배포 패턴
| 패턴 | 위험 | 대안 |
|------|------|------|
| 금요일 오후 배포 | 주말 장애 대응 불가 | 월-목 오전 배포 |
| 롤백 계획 없이 배포 | 장애 시 복구 지연 | 항상 롤백 플레이북 작성 |
| 모니터링 없이 배포 | 장애 인지 지연 | 최소 헬스체크 + 알림 |
| 빅뱅 배포 (100% 즉시) | 전체 사용자 영향 | 카나리 → 점진적 확대 |
| DB 스키마 + 앱 동시 배포 | 롤백 복잡도 급증 | 스키마 먼저, 앱 따로 |
| 수동 배포 스크립트 | 실수 가능성 | CI/CD 파이프라인 |
---
## 파이프라인 위치
/zephermine → /agent-team → /code-reviewer → /release → /launch 설계 구현 리뷰 버전 출시 체크
**독립 실행 가능** — 파이프라인 밖에서 단독 사용.
---
## Related Files
| 파일 | 역할 |
|------|------|
| `docs/rollout-plan-*.md` | 롤아웃 계획 |
| `docs/rollback-playbook-*.md` | 롤백 플레이북 |
| `skills/release-notes/SKILL.md` | 버전 + CHANGELOG 생성 |
| `skills/deploymonitor/SKILL.md` | 배포 모니터링 |
| `skills/argos/SKILL.md` | 구현 검증 (감리) |