릴리즈 공지 플레이북¶
배포 버튼을 누른 뒤가 진짜 시작이다. 무엇을, 누구에게, 어떻게 알릴지를 그때그때 즉흥으로 정하면 빠뜨리는 게 생기고, 사용자는 "갑자기 뭐가 바뀌었지?"로 신뢰를 잃는다. 이 플레이북은 기능이나 버그픽스를 배포한 직후 따라가는 길이다. 배포 절차 자체는 version-control, 배포 전 QA 게이트는 qa-playbook, 신규 기능을 시장에 내보낼 때의 합동 점검은 gtm-launch-checklist가 맡는다.
전체를 책임지고 일정과 전략을 끄는 건 PM이다. 다만 릴리즈 노트를 누가 쓰고 문제가 생기면 누가 롤백할지는 그 릴리즈 시점에 지정한다 — 매번 같은 사람일 필요는 없다.
단계 흐름¶
릴리즈는 한 번에 펑 터뜨리지 않고 단계로 흘린다. 각 단계는 D-Day 기준 +n일로 잡아 일정에 박는다.
릴리즈 전 게이트¶
퍼블릭에 열기 전, 다음을 한 번씩 확인하고 넘어간다. 특히 DB 마이그레이션과 롤백 경로는 빠뜨리면 배포 후 손쓸 수 없는 항목이라 매번 챙긴다.
- QA 스모크/E2E 통과 (qa-playbook) — 승인 기준 P0 100% · P1 80%
- 변경 요약 정리 — 기능·버그픽스·마이그레이션을 PR/이슈에서 추출
- 릴리즈 범위 확정 — 포함/제외 기능 명시 (예: 포함=로그인·스터디룸·노트 / 제외=알림·영상)
- DB 마이그레이션 필요 시 PROD DDL 실행 확인 (
auto ddl=none, tools-accounts) - 환경 확인 — dev/stage/prod 서버 경로·도메인·SSL 정상 (version-control)
- 롤백 경로 확인 — 롤백 시나리오·장애 대응 담당자 지정, 버전 태그 규칙(
v1.0.0-mvp) - 트래킹 셋업 — 성공 지표용 이벤트(
studyroom_create·note_write·dashboard_view등) 수집 확인
공지 작성¶
🚧 내용 추가 필요
원본 릴리즈 전략 문서는 "내부 공지 프로세스를 정의한다 / 외부 공지가 필요하면 안내문을 작성한다"까지만 정하고 구체 채널은 미확정으로 둔다. 아래 본문의 "Slack 릴리즈 채널 / 인앱·카톡 오픈채팅"은 잠정 가정이다 — 실제 내부 공지 채널 이름과 외부 공지 채널을 확정해 tools-accounts에 등재하고, 릴리즈 노트 작성자 지정 규칙(매번 지정인지, 고정 담당인지)을 확정해 주세요.
공지는 안에 먼저, 밖은 필요할 때만 한다. 내부 공지는 Slack 릴리즈 채널에 올리고, 버전·날짜, 사용자 관점에서 본 주요 변경, 알려진 이슈, 영향 범위와 다운타임, 담당·문의처를 담는다. 외부 공지는 사용자 영향이 큰 변경에 한해 인앱·카톡 오픈채팅·베타 안내문으로 내보내며, "무엇이 좋아졌나"를 사용자 말로 한두 줄이면 충분하다. 어디서 공지하든 결정·리소스·릴리즈 노트는 Jira 이슈에 박제해 둔다 — 채팅에만 남기면 며칠 뒤 사라진다(how-we-work §Jira 운영).
공지 템플릿 (복붙용)¶
[d-edu vX.Y.Z — YYYY-MM-DD]
• 새 기능 / 개선: <사용자 관점 1~2줄>
• 버그픽스: <간단히>
• 알려진 이슈: <있으면> / 없으면 "없음"
• 영향 범위·다운타임: <무중단 / 점검 N분>
• 문의: <CS 채널 — [[cs-policy]]>
릴리즈 후¶
- 모니터링 — 로그·지표에 이상이 없는지 (관측성 스택은 infra)
- 성공 지표 추적 — 가입 전환·재방문·오류 리포트 수를 이벤트 트래킹으로 (PM이 주·격주로 검토)
- 피드백 채널 가동 — 구글폼·Slack 피드백을 cs-policy·feedback로 연결
- 인시던트 시 incidents에 기록하고 런북 가동, 필요하면 긴급 롤백
- 후속 — 모인 피드백·데이터를 다음 버전(v1.1) 기획 근거로, sprints 회고에 반영
릴리즈 후에 한 가지 우선순위를 분명히 해둔다. 장애가 터지면 공지부터 쓰려 하지 말고 롤백과 인시던트 절차(incidents)를 먼저 돌린다 — 사용자에게 알리는 건 그다음이다.
이 과정에서 쓰는 도구는 내부 공지용 Slack 릴리즈 채널, 외부 공지용 인앱·카톡 오픈채팅, 결정과 릴리즈 노트를 박제하는 Jira, 변경 요약을 뽑아내는 GitHub PR·이슈, 그리고 지표용 이벤트 트래킹(GA 등)이다. 접근 경로는 tools-accounts에 있다.
관련¶
version-control · qa-playbook · gtm-launch-checklist · cs-policy · incidents