# Release

> dev → main 릴리즈 PR을 생성하고, 머지한 뒤, main → dev 백머지까지 수행하는 릴리즈 워크플로우 스킬. Use when this capability is needed.

- Skill: `tomevault-io/release-97` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/release-97`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/release-97/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/release-97

---


다음 단계를 순서대로 수행한다:

## 1. 사전 검증
- 현재 브랜치가 `dev`인지 확인한다. 아니면 중단하고 사용자에게 알린다.
- 워킹 트리가 clean한지 확인한다. 커밋되지 않은 변경사항이 있으면 중단하고 사용자에게 알린다.
- `git pull origin dev`로 최신 상태를 가져온다.
- `dev`에 `main` 대비 새로운 커밋이 있는지 `git log main..dev --oneline`으로 확인한다. 새 커밋이 없으면 중단한다.

## 2. 릴리즈 PR 생성
- `git log main..dev --oneline`으로 포함될 커밋 목록을 가져온다.
- GitHub MCP 도구(`create_pull_request`)로 PR을 생성한다:
  - **head**: `dev`
  - **base**: `main`
  - **title**: `Release: dev → main`
  - **body**: 포함되는 커밋 목록을 bullet point로 정리한다
- 생성된 PR 번호와 URL을 사용자에게 보여준다.

## 3. PR 머지
- 사용자에게 머지 진행 여부를 확인받는다.
- 확인되면 GitHub MCP 도구(`merge_pull_request`)로 **반드시 `merge` 방식**(Create Merge Commit)으로 머지한다. **squash나 rebase를 절대 사용하지 않는다.**

## 4. 백머지 (main → dev)
- 머지 후 CI(semantic-release)가 `main`과 `dev` 브랜치에 version bump 커밋을 푸시할 때까지 기다려야 한다.
- 머지 커밋 SHA를 기준으로, `main` 브랜치에 그 이후의 새로운 커밋(version bump)이 나타날 때까지 폴링한다:
  - `git fetch origin` 후 `git log <merge_sha>..origin/main --oneline`으로 새 커밋이 있는지 확인한다.
  - 새 커밋이 없으면 30초 간격으로 재시도하며, 최대 5분간 대기한다.
  - 5분 내에 새 커밋이 나타나지 않으면 사용자에게 알리고, 백머지를 수동으로 진행하도록 안내한다.
- version bump 커밋이 확인되면:
  - `git checkout dev && git pull origin dev`로 dev 브랜치를 업데이트한다.
  - `git merge origin/main`으로 main을 dev에 백머지한다.
  - 충돌이 발생하면 사용자에게 알리고 수동 해결을 요청한다.
  - 충돌이 없으면 `git push origin dev`로 푸시한다.

## 5. 완료 보고
- 릴리즈 PR URL, 머지 결과, 백머지 결과를 요약하여 사용자에게 보고한다.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/async3619) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->