| name | vr-deploy-plan |
| description | 배포 플랜을 작성할 때 사용하는 스킬. 사용자가 '배포 플랜 만들어줘', '배포 페이지 작성', '배포 트래커 작성', 'deploy plan' 등을 요청하거나, 상용 배포 준비가 필요할 때 트리거한다. |
배포 플랜 작성
Notion 배포 트래커 DB에 배포 플랜 페이지를 생성하고 사용자와 공동 작성한다.
- 배포 트래커 DB:
https://www.notion.so/20bcf5759dc080edac25d6220aafdefb
- JIRA:
https://vroong-jira.atlassian.net
- DB 속성, 옵션, 템플릿 구조는 모두 런타임에 Notion에서 동적 조회한다
워크플로우
Phase 1~4: 정보 수집 (병렬)
네 단계는 서로 의존성이 없으므로 병렬 실행한다.
Phase 1: Diff 탐색
- 최근 태그 목록을 조회한다
- SNAPSHOT, RC 등 비상용 태그를 제외하고 상용 배포 태그만 필터링한다
- 필터링된 태그 목록을 사용자에게 보여주고 배포 태그를 확인한다
- 롤백 버전을 결정한다: 배포 태그 바로 이전 상용 태그를 자동 선택하여 사용자에게 확인한다
- 상용 태그 간 변경 내역을 수집한다 (롤백 버전 ~ 배포 태그):
- git log, git diff --stat
- 커밋 메시지에서 JIRA 티켓 번호를 추출하여 JIRA 링크를 생성한다 (예:
https://vroong-jira.atlassian.net/browse/ITSMCHG-30747)
- Merge commit에서 PR 번호를 추출하여 PR 제목/링크를 수집한다
- 추출된 티켓/PR 링크는 초안 작성 시 관련 섹션에 포함한다
태그가 없는 경우(최초 배포): 사용자에게 비교 기준을 확인한다.
Phase 2: 템플릿 탐색
- Notion 배포 트래커 DB에서 템플릿 목록을 조회한다
- 가장 최신 템플릿을 사용자에게 제안하여 확인한다
- 확정된 템플릿을 fetch하여 섹션 구조를 파악한다
Phase 3: 기존 배포 플랜 탐색
- Notion 배포 트래커 DB에서 최근 완료된 배포 플랜 3~5건을 조회한다
- 문서 스타일, 작성 패턴, 톤을 파악한다
- 초안 작성 시 일관성 유지를 위한 레퍼런스로 활용한다
기존 배포 플랜이 없는 경우: 템플릿 구조만으로 진행한다.
Phase 4: 사용자 식별
- Notion API로 현재 사용자의 프로필(이름, ID)을 조회한다
- 조회한 사용자 정보는 Phase 7(페이지 생성)에서 작성자 설정에 활용한다
사용자 프로필 조회에 실패한 경우: 사용자에게 이름을 직접 확인한다.
Phase 5: 분석 및 구체화
Phase 1~4의 결과를 합류하여:
- 섹션 분류: 템플릿 섹션을 diff 데이터와 대조하여 "자동 초안 가능" / "사용자 논의 필요"로 분류한다
- 정보 파악: 자동으로 채울 수 없는 항목을 사용자에게 질문하여 수집한다
- 배포를 실제 수행하는 담당자(배포 오퍼레이터)는 누구인가?
- 이번 배포로 영향받는 서비스/모듈은 무엇인가?
- 배포 시작 시간과 각 단계별 소요 시간은 얼마인가?
- 예상 위험 요소는 무엇인가?
- QA 상태와 관련 문서 링크는?
- 배포 순서는 어떻게 되는가?
- 위 항목은 기본 질문이다. 섹션 분류 결과 자동으로 채울 수 없는 항목이 추가로 발견되면, 해당 섹션에 맞는 질문을 추가로 생성하여 사용자에게 확인한다
Phase 6: 초안 작성 + 보완
- "자동 초안 가능"으로 분류된 섹션은 diff 데이터 + 기존 문서 스타일을 참조하여 초안을 작성한다
- "사용자 논의 필요"로 분류된 섹션은 사용자와 하나씩 확인/보완한다
- 각 섹션 확인 후 최종 확정한다
Phase 7: 페이지 생성
- Notion 배포 트래커 DB에 페이지를 생성한다 (확정된 템플릿 적용)
- DB 속성을 설정한다 (동적으로 조회한 옵션 기반, 사용자 확인 후)
- Phase 4에서 조회한 사용자 정보로 작성자를 설정한다
- 확정된 본문 내용을 채운다
- 생성된 페이지 URL을 사용자에게 공유한다
주의사항
- 페이지 제목 형식: 기존 배포 플랜의 패턴을 따른다
- 진행 상태는 "작성중"으로 시작한다
- 배포일은 사용자에게 확인 후 설정한다 (임의로 넣지 않음)
- 롤백 버전은 이전 상용 태그 기반으로 제안하고, 사용자 확인을 필수로 한다
- DB 속성은 후보를 제안하여 사용자가 확정한다
- 매칭되는 옵션이 없으면 비워두고 사용자에게 확인한다
- 본문 레이아웃은 단일 컬럼으로 작성한다
- TOC(목차)가 포함된 템플릿의 경우, TOC를 좌/우 컬럼 레이아웃으로 배치하지 않고 페이지 상단에 배치한다 (Notion MCP가 full width column을 지원하지 않음)
- 배포 시간은 사용자에게 시작 시간과 단계별 소요 시간을 확인한 뒤, 누적 계산하여 기입한다 (임의로 채우지 않음)
- Notion 접근 실패 시 사용자에게 알리고 대안을 제시한다
