macos-release

name	macos-release
description	macOS 앱/CLI 릴리스 작업을 자동화하거나 가이드합니다. 버전 범프, Release 빌드, DMG/ZIP, GitHub Release, Homebrew 배포가 필요할 때 사용합니다.

macOS Release

원본 macos-release를 Codex repo-local skill로 이식한 버전입니다.

When to use

• macOS 앱/CLI의 버전 범프, 빌드, 패키징, GitHub Release, Homebrew 배포가 필요할 때
• 기존 릴리스 스크립트나 체크리스트를 따라 repeatable release flow를 실행할 때
• 로컬 검증을 거친 뒤 공개 단계까지 안전하게 진행해야 할 때

Do not use when

• 일반 기능 개발이나 버그 수정처럼 릴리스 준비가 아닌 작업
• App Store / TestFlight 중심의 iOS 릴리스 작업
• 단순 PR 리뷰나 코드 감사만 필요한 작업

Quick start

1. 기존 릴리스 스크립트, 프로젝트, tap 저장소를 탐지한다.
2. dry-run 또는 로컬 검증 계획을 먼저 세운다.
3. 버전 범프 → 빌드 → 패키징 → 로컬 설치 → 체크섬 순으로 실행한다.
4. 검증이 끝난 뒤에만 GitHub Release와 Homebrew 단계를 진행한다.

Use references

• references/release-checklist.md
• references/release-script-guide.md
• references/local-install-and-dmg.md
• references/github-workflow-guide.md
• references/homebrew-publishing.md
• references/troubleshooting.md

Workflow

1. 프로젝트에서 기존 릴리스 스크립트, Xcode 프로젝트, tap 저장소를 탐지한다.
2. 파괴적 작업 전에는 항상 dry-run 또는 로컬 검증 단계를 먼저 수행한다.
3. 버전 범프 → 빌드 → 패키징 → 로컬 설치 확인 → GitHub Release → Homebrew 순서를 지킨다.
4. 기존 스크립트가 있으면 우선 재사용하고, 없으면 최소 스크립트를 생성한다.
5. 실패 시 어느 단계에서 멈췄는지와 복구 방법을 함께 보고한다.

Guardrails

• 로컬 설치 검증 전 외부 공개 단계를 진행하지 않는다.
• GitHub/API 인증 상태를 먼저 확인한다.
• Homebrew 갱신은 릴리스 산출물 체크섬이 확정된 뒤에만 수행한다.

Review Harness

• mode: required
• 공통 기준: ../../../docs/review-harness.md
• planner: 기존 릴리스 경로, dry-run, 공개 순서를 먼저 정한다
• generator: 버전 범프, 빌드, 패키징, 배포 준비를 수행한다
• evaluator: dry-run, 로컬 설치, 체크섬, release checklist로 결과를 검토한다
• 평가축: release completeness, 로컬 검증 통과, 산출물 무결성, 공개 순서 준수
• artifacts/evidence: build log, 패키지 경로, 체크섬, 설치 확인, 릴리스 노트
• pass condition: 로컬 검증과 산출물 무결성이 확인되기 전에는 외부 공개 단계로 넘어가지 않는다
• 자동 다음 행동: pass면 공개 단계 진행, refine이면 빌드/패키징 수정, stop이면 외부 공개 중단, critical이면 checksum 또는 install 문제 해결 전 병합/배포를 금지한다

Output expectation

• 감지한 릴리스 경로와 단계
• 완료/실패/보류 단계
• build log, 패키지, 체크섬, 로컬 설치 검증 요약
• 다음 공개 액션 또는 중단 사유