release-check

name	release-check
description	claude-pet 릴리스/배포 전 점검 — gradle.properties 버전 정합성, 3단 빌드 검증(compile → 개발 실행 → 번들), README/docs 동기화, release-please 상태를 확인한다. 트리거 — '릴리스 점검', '배포 전 확인', 'release-check', '릴리스 준비됐는지 봐줘'.

release-check

이 skill은 claude-pet 릴리스/배포 전에 사람이 매번 손으로 확인하던 항목을 한 절차로 점검한다. "컴파일 성공 = 동작 성공"이 아니라는 프로젝트 규칙(.claude/CLAUDE.md "작업 흐름")을 강제한다. 검증 전용이며 파일을 만들거나 수정하지 않는다.

사용 시점

• release-please Release PR을 머지해 v* 태그로 배포하기 직전.
• 기능 PR을 올리기 전, 번들 단계에서만 드러나는 회귀를 미리 잡고 싶을 때.
• UI/리소스 경로/패키징 설정을 바꾼 뒤.

사용하지 않는 경우

• 문서만 바뀐 변경(빌드·번들 영향 없음).
• 하네스 파일(.claude/, docs/, .mcp.json)만 바뀐 경우 — 이건 /verify가 담당한다.

절차

모든 gradle 명령은 프로젝트 루트에서 실행한다.

1. 버전 정합성
   • gradle.properties의 projectVersion 라인이 # x-release-please-start-version ~ # x-release-please-end 마커 사이에 있는지 확인한다(release-please가 bump하는 위치).
   • git tag --list 'v*'의 최신 태그와 projectVersion을 비교한다. 이미 배포된 버전과 같으면 새 릴리스가 아니므로 사용자에게 확인한다.
2. 3단 빌드 검증 (.claude/CLAUDE.md "작업 흐름" 기준)
   • 1단계 컴파일: ./gradlew :composeApp:compileKotlinJvm
   • 2단계 개발 실행: ./gradlew :composeApp:run — 창이 뜨고 펫이 렌더되는지 육안 확인. UI 변경이 없으면 생략 가능하며, 생략 시 "미검증"으로 기록한다.
   • 3단계 번들 실행: 현재 OS 기준 ./gradlew :composeApp:packageDmg(macOS) 또는 ./gradlew.bat :composeApp:packageMsi(Windows). 산출물이 dist/에 생성됐는지 확인하고, 번들 앱을 실제로 실행해 jlink 런타임 누락·리소스 경로 이슈가 없는지 본다.
3. 문서 동기화
   • 기능이 추가/변경됐다면 README.md의 해당 섹션이 갱신됐는지 확인한다(프로젝트 규칙: README 동기화).
   • 사용자 노출 변경이면 docs/설치방법.txt 등 설치 가이드 영향 여부를 확인한다.
4. release-please 상태
   • release-please-config.json과 .release-please-manifest.json이 존재하는지 확인한다.
   • 최근 커밋 메시지가 Conventional Commits(docs/commit-convention.md)를 따르는지 확인한다 — release-please가 버전·CHANGELOG를 이 커밋으로 계산한다.

검증 기준

• 1·3단계 gradle 명령의 종료 코드가 0이다.
• dist/에 ClaudePet-<projectVersion>.dmg 또는 ClaudePet-<projectVersion>.msi가 생성됐다.
• projectVersion이 최신 v* 태그보다 높은 SemVer다.
• 기능 변경이 있으면 README.md diff에 해당 섹션 변경이 있다.
• 실행하지 못한 단계(예: 다른 OS의 번들)는 PASS로 적지 않고 "미검증"으로 분리한다.

출력 형식

## release-check 결과

- 버전 정합성: PASS / FAIL / 미검증 — projectVersion=<값>, 최신 태그=<값>
- 컴파일(1단계): PASS / FAIL — <gradle 결과>
- 개발 실행(2단계): PASS / FAIL / 생략 — <육안 확인 결과>
- 번들(3단계): PASS / FAIL / 미검증 — <산출물 경로>
- 문서 동기화: PASS / FAIL / 해당 없음
- release-please 상태: PASS / FAIL / 미검증

## 문제
- <항목>: <문제와 근거>

## 미검증
- <실행하지 못한 단계와 이유 — 예: Windows 번들은 현재 OS(macOS)에서 빌드 불가>