The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml You MUST have already loaded and processed: {installed_path}/workflow.yaml Communicate all responses in {communication_language} 🔧 PUBLIC RELEASE SETUP - Private → Public 릴리스 자동화 설정

📋 **Public 릴리스 자동화 설정** 이 워크플로우는 Private 저장소에서 태그 push 시 Public 저장소에 자동으로 릴리스(바이너리 + 문서)를 배포하는 파이프라인을 설정합니다: - Public 릴리스 저장소 생성 - GitHub Actions 워크플로우 생성 (release-to-public.yml) - Secrets (PAT) 설정 가이드

git repository 확인: git rev-parse --git-dir

⚠️ Git 저장소가 감지되지 않습니다. Git 저장소에서 실행해주세요.

HALT gh CLI 확인: gh --version

⚠️ GitHub CLI(gh)가 설치되지 않았습니다. 설치 방법: - Windows: winget install GitHub.cli - macOS: brew install gh - Linux: https://github.com/cli/cli#installation 설치 후 `gh auth login`으로 인증해주세요.

HALT gh CLI 인증 확인: gh auth status

⚠️ GitHub CLI 인증이 필요합니다.

`gh auth login`을 실행하시겠습니까? [y/n] gh auth login 안내 제공 HALT .github/workflows 디렉토리 확인 (없으면 생성) 현재 저장소 정보 추출: gh repo view --json owner,name -q '.owner.login + "/" + .name' {{private_owner}} = owner, {{private_repo}} = name

✅ 환경 확인 완료 - Private 저장소: {{private_owner}}/{{private_repo}}

📝 PROJECT INFO - 빌드 및 릴리스 정보 수집 Public 릴리스 저장소 이름을 입력해주세요 (예: {{private_repo}}-releases): {{public_repo_name}} = 사용자 입력값 프로젝트 설명을 입력해주세요 (Public 저장소 description): {{project_description}} = 사용자 입력값

📋 **빌드 런타임 선택** 프로젝트의 빌드 런타임을 선택해주세요: 1. Node.js — npm ci / npm run build 2. Go — go build 3. Rust — cargo build --release 4. .NET — dotnet publish 5. Python — python -m build 6. Java — ./gradlew build 7. 커스텀 — 직접 설정

빌드 런타임을 선택해주세요: [1-7] {{setup_action}} = "actions/setup-node@v4" {{setup_with}} = "node-version: '20'" {{install_cmd}} = "npm ci" {{build_cmd}} = "npm run build" {{artifact_path}} = "dist/" {{runtime_label}} = "Node.js" {{setup_action}} = "actions/setup-go@v5" {{setup_with}} = "go-version: 'stable'" {{install_cmd}} = "" {{build_cmd}} = "go build -o ./build/ ./..." {{artifact_path}} = "build/" {{runtime_label}} = "Go" {{setup_action}} = "dtolnay/rust-toolchain@stable" {{setup_with}} = "" {{install_cmd}} = "" {{build_cmd}} = "cargo build --release" {{artifact_path}} = "target/release/" {{runtime_label}} = "Rust" {{setup_action}} = "actions/setup-dotnet@v4" {{setup_with}} = "dotnet-version: '8.0.x'" {{install_cmd}} = "dotnet restore" {{build_cmd}} = "dotnet publish -c Release -o ./publish" {{artifact_path}} = "publish/" {{runtime_label}} = ".NET" {{setup_action}} = "actions/setup-python@v5" {{setup_with}} = "python-version: '3.x'" {{install_cmd}} = "pip install -r requirements.txt" {{build_cmd}} = "python -m build" {{artifact_path}} = "dist/" {{runtime_label}} = "Python" {{setup_action}} = "actions/setup-java@v4" {{setup_with}} = "distribution: 'temurin'\n java-version: '21'" {{install_cmd}} = "" {{build_cmd}} = "./gradlew build" {{artifact_path}} = "build/libs/" {{runtime_label}} = "Java" 런타임 setup action을 입력해주세요 (없으면 빈 값): {{setup_action}} = 사용자 입력값 setup action의 with 매개변수를 입력해주세요 (없으면 빈 값): {{setup_with}} = 사용자 입력값 의존성 설치 명령어를 입력해주세요 (없으면 빈 값): {{install_cmd}} = 사용자 입력값 빌드 명령어를 입력해주세요: {{build_cmd}} = 사용자 입력값 빌드 결과물 경로를 입력해주세요: {{artifact_path}} = 사용자 입력값 {{runtime_label}} = "커스텀"

ℹ️ 기본값이 설정되었습니다. 다음에서 세부 사항을 조정할 수 있습니다.

빌드 명령어를 수정하시겠습니까? (현재: {{build_cmd}}) [y/n] 새 빌드 명령어를 입력해주세요: {{build_cmd}} = 사용자 입력값 설치 명령어를 수정하시겠습니까? (현재: {{install_cmd}}) [y/n] 새 설치 명령어를 입력해주세요: {{install_cmd}} = 사용자 입력값 빌드 결과물 경로를 수정하시겠습니까? (현재: {{artifact_path}}) [y/n] 새 결과물 경로를 입력해주세요: {{artifact_path}} = 사용자 입력값 릴리스에 첨부할 파일 패턴을 입력해주세요 (예: dist/*.zip, dist/*.tar.gz 등, 여러 줄 가능): {{artifact_patterns}} = 사용자 입력값 라이선스를 선택해주세요: 1. MIT 2. Apache-2.0 3. GPL-3.0 4. BSD-3-Clause 5. 없음 (건너뛰기) {{license_type}} = 사용자 선택값

📋 **수집된 정보 요약** - Public 저장소: {{private_owner}}/{{public_repo_name}} - 설명: {{project_description}} - 런타임: {{runtime_label}} - 빌드: {{build_cmd}} - 설치: {{install_cmd}} - 결과물 경로: {{artifact_path}} - 릴리스 패턴: {{artifact_patterns}} - 라이선스: {{license_type}}

위 정보가 맞습니까? [y/n]

❌ 설정을 취소합니다. 다시 실행해주세요.

HALT 🏗️ CREATE PUBLIC REPO - Public 릴리스 저장소 생성 저장소 존재 확인: gh repo view {{private_owner}}/{{public_repo_name}} 2>/dev/null

⚠️ {{private_owner}}/{{public_repo_name}} 저장소가 이미 존재합니다.

기존 저장소를 사용하시겠습니까? [y/n]

❌ 설정을 취소합니다.

HALT

ℹ️ 기존 저장소를 사용합니다.

gh repo create {{private_owner}}/{{public_repo_name}} --public --description "{{project_description}}"

✅ Public 저장소 생성됨: {{private_owner}}/{{public_repo_name}}

임시 디렉토리 생성 및 이동 git clone https://github.com/{{private_owner}}/{{public_repo_name}}.git temp-public-repo cd temp-public-repo README.md 생성: # {{public_repo_name}} {{project_description}} ## 설치 [릴리스 페이지](https://github.com/{{private_owner}}/{{public_repo_name}}/releases)에서 최신 버전을 다운로드하세요. ## 라이선스 {{license_type}} 라이선스에 따라 배포됩니다. CHANGELOG.md 생성: # Changelog 이 프로젝트의 주요 변경사항을 기록합니다. 형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며, [Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다. LICENSE 파일 생성 (선택된 라이선스 유형에 맞는 전문) git add -A git commit -m "chore: 저장소 초기화 Generated by BMAD Method - Public Release Setup" git push origin main 임시 디렉토리 정리 (cd .. && rm -rf temp-public-repo)

✅ 초기 파일 Push 완료: - README.md - CHANGELOG.md {{license_file_note}}

⚙️ ACTIONS WORKFLOW - release-to-public.yml 생성 {{release_templates}}/release-to-public.yml 기본 템플릿 로드 플레이스홀더 교체: - __PUBLIC_REPO__ → {{private_owner}}/{{public_repo_name}} - __SETUP_ACTION__ → {{setup_action}} (비어있으면 해당 step 제거) - __SETUP_WITH__ → {{setup_with}} (비어있으면 with 블록 제거) - __INSTALL_CMD__ → {{install_cmd}} (비어있으면 해당 step 제거) - __BUILD_CMD__ → {{build_cmd}} - __ARTIFACT_PATH__ → {{artifact_path}} - __ARTIFACT_PATTERNS__ → {{artifact_patterns}}

⚠️ release-to-public.yml이 이미 존재합니다.

덮어쓰시겠습니까? [y/n]

ℹ️ 기존 파일을 유지합니다.

기존 파일 백업: release-to-public.yml.backup 생성된 워크플로우를 {{target_workflows_dir}}/release-to-public.yml에 저장

✅ release-to-public.yml 덮어쓰기 완료 (백업 생성됨)

생성된 워크플로우를 {{target_workflows_dir}}/release-to-public.yml에 저장

✅ release-to-public.yml 생성 완료

📄 **생성된 워크플로우 요약** 파일: .github/workflows/release-to-public.yml 트리거: v* 태그 push 동작: 1. 소스 체크아웃 2. {{runtime_label}} 런타임 설정 3. 의존성 설치 및 빌드 4. CHANGELOG에서 릴리스 노트 추출 5. Public 저장소에 릴리스 생성 + 아티팩트 첨부 6. Public 저장소에 CHANGELOG.md 동기화

🔑 SECRETS - GitHub Actions Secrets 설정

📋 **Fine-grained Personal Access Token (PAT) 생성 가이드** Public 저장소에 릴리스를 배포하려면 PAT가 필요합니다. **생성 방법:** 1. GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens 2. "Generate new token" 클릭 3. 설정: - Token name: `public-release-{{public_repo_name}}` - Expiration: 원하는 기간 (권장: 90일, 이후 갱신) - Resource owner: {{private_owner}} - Repository access: "Only select repositories" → **{{public_repo_name}}** 선택 - Permissions: - Contents: Read and write - Metadata: Read-only (자동 선택됨) 4. "Generate token" 클릭 후 토큰 복사 ⚠️ 토큰은 한 번만 표시됩니다. 반드시 복사해두세요!

PAT를 생성하셨습니까? Secret을 설정할 준비가 되셨습니까? [y/n]

ℹ️ 다음 명령어로 Secret을 설정합니다: `gh secret set PUBLIC_REPO_TOKEN -R {{private_owner}}/{{private_repo}}` 프롬프트에 복사한 PAT 토큰을 붙여넣어주세요.

gh secret set PUBLIC_REPO_TOKEN -R {{private_owner}}/{{private_repo}}

✅ PUBLIC_REPO_TOKEN Secret 설정 완료

⚠️ Secret 설정에 실패했습니다. 수동으로 설정하려면: 1. GitHub → {{private_owner}}/{{private_repo}} → Settings → Secrets and variables → Actions 2. "New repository secret" 클릭 3. Name: PUBLIC_REPO_TOKEN 4. Secret: 생성한 PAT 토큰 5. "Add secret" 클릭

ℹ️ Secret 설정을 건너뜁니다. 나중에 설정하려면: `gh secret set PUBLIC_REPO_TOKEN -R {{private_owner}}/{{private_repo}}` 또는 GitHub 웹에서: {{private_owner}}/{{private_repo}} → Settings → Secrets and variables → Actions

🎉 **Public 릴리스 자동화 설정 완료!** **설정된 항목:** ✅ Public 저장소: {{private_owner}}/{{public_repo_name}} ✅ Actions 워크플로우: .github/workflows/release-to-public.yml ✅ Secret: PUBLIC_REPO_TOKEN **릴리스 방법:** 1. CHANGELOG.md에 새 버전 섹션 추가 2. 태그 생성 및 Push: ``` git tag v1.0.0 git push origin v1.0.0 ``` 3. GitHub Actions가 자동으로: - 프로젝트 빌드 - CHANGELOG에서 릴리스 노트 추출 - Public 저장소에 릴리스 생성 + 아티팩트 첨부 - Public 저장소에 CHANGELOG.md 동기화 **확인:** - Private Actions: https://github.com/{{private_owner}}/{{private_repo}}/actions - Public Releases: https://github.com/{{private_owner}}/{{public_repo_name}}/releases **주의사항:** - PAT 토큰은 만료 기간이 있으므로 갱신이 필요합니다 - Private 저장소의 소스 코드는 Public에 노출되지 않습니다 - 릴리스에 첨부되는 아티팩트만 공개됩니다

변경사항(.github/workflows/release-to-public.yml)을 지금 커밋하시겠습니까? [y/n] git add .github/workflows/release-to-public.yml git commit -m "ci: Public 릴리스 자동 배포 워크플로우 추가 - release-to-public.yml: v* 태그 push 시 Public 저장소에 릴리스 배포 - 빌드 → 아티팩트 첨부 → CHANGELOG 동기화 Generated by BMAD Method"

✅ 커밋 완료! Push하려면: `git push origin {{current_branch}}`

지금 Push하시겠습니까? [y/n] git push origin {{current_branch}}

✅ Push 완료!