Prompt file imported from sympotalk/SympotalkLauncher-APK (.claude/commands/rollback.md). Copyright stays with the author.

/rollback — 긴급 롤백

Name: rollback
Author: sympotalk

서비스 중단·치명적 버그 시 직전 안정 버전으로 되돌립니다.

절차

1. 직전 안정 버전 식별

git log --oneline -10
gh release list --limit 5

후보:

version.txt가 가리키는 현재 버전 직전(v(N-1))
마지막으로 GitHub Release make_latest=true였던 태그
CI 마지막 success 커밋

2. 롤백 계획 출력 (사용자 승인 대기)

🚨 롤백 계획

현재: v1.0.43 (commit 170446e) — 문제 발생
목표: v1.0.42 (commit 789cbcc) — 마지막 안정

방식: revert (forward commit, 히스토리 보존)
  ├─ git revert 170446e --no-edit
  ├─ version.txt: 1.0.43 → 1.0.42
  ├─ build.gradle: versionCode 39 → 38, versionName "1.0.43" → "1.0.42"
  └─ git push origin main

영향:
  - APK CI가 v1.0.42를 다시 빌드 (versionCode 동일하면 거부될 수 있음 → 별도 처리)
  - Cloudflare Pages 즉시 배포

⚠️  versionCode 후퇴는 Android에서 거부됨. revert 후 versionCode를 41로 bump하고
    versionName은 "1.0.42-rollback" 처럼 표기 권장.

계속 진행할까요? (yes/no)

yes 입력 전엔 절대 실행하지 말 것.

3. 승인 후 실행

git revert <bad-commit> --no-edit
# 필요 시 version.txt + build.gradle 수정 (versionCode는 forward bump)
git add version.txt android-app/app/build.gradle
git commit --amend --no-edit
git push origin main

4. 인시던트 기록

docs/incidents/<YYYY-MM-DD>-<HHMM>-<short-slug>.md 생성. 템플릿은 docs/incidents/README.md 참조.

5. GitHub Issue 자동 생성

gh issue create \
  --title "[INCIDENT] <원인 요약>" \
  --label "priority/p0,incident" \
  --body "$(cat <<EOF
## 발생
<일시 + 영향 범위>

## 즉시 조치
- 롤백 커밋: <hash>
- 롤백 대상: <bad commit hash>

## 근본 원인 (조사 필요)
TODO

## 후속 작업
- [ ] 근본 원인 분석
- [ ] 재발 방지 PR
- [ ] docs/incidents/<file> 작성

상세: docs/incidents/<file>
EOF
)"

6. CI 모니터링

gh run watch <new-run-id> --exit-status

빌드 실패하면 사용자에게 즉시 보고. 더 이전 버전으로 추가 롤백 검토.

출력

🔄 롤백 완료
- 롤백 커밋: <hash>
- 새 버전: v<X.Y.Z>-rollback
- CI: <URL>
- 인시던트 보고서: docs/incidents/<file>
- GitHub Issue: #<num>

다음:
- 근본 원인 분석 후 docs/incidents/<file> 의 "근본 원인" 섹션 작성
- 재발 방지 PR 작성

주의 (절대 자동 실행 금지)

git push --force 사용 금지. revert 패턴만 사용.
git reset --hard 사용 금지. 커밋 히스토리 보존.
versionCode를 후퇴시키지 말 것 (Android Play 거부, GitHub Release는 허용해도 사용자 OTA가 거부됨).
사용자 명시 승인 없이 진행 금지.

# /rollback — 긴급 롤백 서비스 중단·치명적 버그 시 직전 안정 버전으로 되돌립니다. ## 절차 ### 1. 직전 안정 버전 식별 ```bash git log --oneline -10 gh release list --limit 5 ``` 후보: - `version.txt`가 가리키는 현재 버전 직전(`v(N-1)`) - 마지막으로 GitHub Release `make_latest=true`였던 태그 - CI 마지막 success 커밋 ### 2. 롤백 계획 출력 (사용자 승인 대기) ``` 🚨 롤백 계획 현재: v1.0.43 (commit 170446e) — 문제 발생 목표: v1.0.42 (commit 789cbcc) — 마지막 안정 방식: revert (forward commit, 히스토리 보존) ├─ git revert 170446e --no-edit ├─ version.txt: 1.0.43 → 1.0.42 ├─ build.gradle: versionCode 39 → 38, versionName "1.0.43" → "1.0.42" └─ git push origin main 영향: - APK CI가 v1.0.42를 다시 빌드 (versionCode 동일하면 거부될 수 있음 → 별도 처리) - Cloudflare Pages 즉시 배포 ⚠️ versionCode 후퇴는 Android에서 거부됨. revert 후 versionCode를 41로 bump하고 versionName은 "1.0.42-rollback" 처럼 표기 권장. 계속 진행할까요? (yes/no) ``` **`yes` 입력 전엔 절대 실행하지 말 것.** ### 3. 승인 후 실행 ```bash git revert <bad-commit> --no-edit # 필요 시 version.txt + build.gradle 수정 (versionCode는 forward bump) git add version.txt android-app/app/build.gradle git commit --amend --no-edit git push origin main ``` ### 4. 인시던트 기록 `docs/incidents/<YYYY-MM-DD>-<HHMM>-<short-slug>.md` 생성. 템플릿은 `docs/incidents/README.md` 참조. ### 5. GitHub Issue 자동 생성 ```bash gh issue create \ --title "[INCIDENT] <원인 요약>" \ --label "priority/p0,incident" \ --body "$(cat <<EOF ## 발생 <일시 + 영향 범위> ## 즉시 조치 - 롤백 커밋: <hash> - 롤백 대상: <bad commit hash> ## 근본 원인 (조사 필요) TODO ## 후속 작업 - [ ] 근본 원인 분석 - [ ] 재발 방지 PR - [ ] docs/incidents/<file> 작성 상세: docs/incidents/<file> EOF )" ``` ### 6. CI 모니터링 ```bash gh run watch <new-run-id> --exit-status ``` 빌드 실패하면 사용자에게 즉시 보고. 더 이전 버전으로 추가 롤백 검토. ## 출력 ``` 🔄 롤백 완료 - 롤백 커밋: <hash> - 새 버전: v<X.Y.Z>-rollback - CI: <URL> - 인시던트 보고서: docs/incidents/<file> - GitHub Issue: #<num> 다음: - 근본 원인 분석 후 docs/incidents/<file> 의 "근본 원인" 섹션 작성 - 재발 방지 PR 작성 ``` ## 주의 (절대 자동 실행 금지) - **`git push --force`** 사용 금지. revert 패턴만 사용. - **`git reset --hard`** 사용 금지. 커밋 히스토리 보존. - versionCode를 후퇴시키지 말 것 (Android Play 거부, GitHub Release는 허용해도 사용자 OTA가 거부됨). - 사용자 명시 승인 없이 진행 금지.

{ "prompt": "# /rollback — 긴급 롤백\n\n서비스 중단·치명적 버그 시 직전 안정 버전으로 되돌립니다.\n\n## 절차\n\n### 1. 직전 안정 버전 식별\n\n```bash\ngit log --oneline -10\ngh release list --limit 5\n```\n\n후보:\n- `version.txt`가 가리키는 현재 버전 직전(`v(N-1)`)\n- 마지막으로 GitHub Release `make_latest=true`였던 태그\n- CI 마지막 success 커밋\n\n### 2. 롤백 계획 출력 (사용자 승인 대기)\n\n```\n🚨 롤백 계획\n\n현재: v1.0.43 (commit 170446e) — 문제 발생\n목표: v1.0.42 (commit 789cbcc) — 마지막 안정\n\n방식: revert (forward commit, 히스토리 보존)\n ├─ git revert 170446e --no-edit\n ├─ version.txt: 1.0.43 → 1.0.42\n ├─ build.gradle: versionCode 39 → 38, versionName \"1.0.43\" → \"1.0.42\"\n └─ git push origin main\n\n영향:\n - APK CI가 v1.0.42를 다시 빌드 (versionCode 동일하면 거부될 수 있음 → 별도 처리)\n - Cloudflare Pages 즉시 배포\n\n⚠️ versionCode 후퇴는 Android에서 거부됨. revert 후 versionCode를 41로 bump하고\n versionName은 \"1.0.42-rollback\" 처럼 표기 권장.\n\n계속 진행할까요? (yes/no)\n```\n\n**`yes` 입력 전엔 절대 실행하지 말 것.**\n\n### 3. 승인 후 실행\n\n```bash\ngit revert <bad-commit> --no-edit\n# 필요 시 version.txt + build.gradle 수정 (versionCode는 forward bump)\ngit add version.txt android-app/app/build.gradle\ngit commit --amend --no-edit\ngit push origin main\n```\n\n### 4. 인시던트 기록\n\n`docs/incidents/<YYYY-MM-DD>-<HHMM>-<short-slug>.md` 생성. 템플릿은 `docs/incidents/README.md` 참조.\n\n### 5. GitHub Issue 자동 생성\n\n```bash\ngh issue create \\\n --title \"[INCIDENT] <원인 요약>\" \\\n --label \"priority/p0,incident\" \\\n --body \"$(cat <<EOF\n## 발생\n<일시 + 영향 범위>\n\n## 즉시 조치\n- 롤백 커밋: <hash>\n- 롤백 대상: <bad commit hash>\n\n## 근본 원인 (조사 필요)\nTODO\n\n## 후속 작업\n- [ ] 근본 원인 분석\n- [ ] 재발 방지 PR\n- [ ] docs/incidents/<file> 작성\n\n상세: docs/incidents/<file>\nEOF\n)\"\n```\n\n### 6. CI 모니터링\n\n```bash\ngh run watch <new-run-id> --exit-status\n```\n\n빌드 실패하면 사용자에게 즉시 보고. 더 이전 버전으로 추가 롤백 검토.\n\n## 출력\n\n```\n🔄 롤백 완료\n- 롤백 커밋: <hash>\n- 새 버전: v<X.Y.Z>-rollback\n- CI: <URL>\n- 인시던트 보고서: docs/incidents/<file>\n- GitHub Issue: #<num>\n\n다음:\n- 근본 원인 분석 후 docs/incidents/<file> 의 \"근본 원인\" 섹션 작성\n- 재발 방지 PR 작성\n```\n\n## 주의 (절대 자동 실행 금지)\n\n- **`git push --force`** 사용 금지. revert 패턴만 사용.\n- **`git reset --hard`** 사용 금지. 커밋 히스토리 보존.\n- versionCode를 후퇴시키지 말 것 (Android Play 거부, GitHub Release는 허용해도 사용자 OTA가 거부됨).\n- 사용자 명시 승인 없이 진행 금지.", "variables": [], "notes": "직전 안정 버전으로 긴급 롤백합니다. 반드시 사용자 승인 후 실행. Tools: Bash(git log:*), Bash(git revert:*), Bash(git push origin:*), Bash(gh release:*), Bash(gh issue create:*), Read, Write.", "metadata": { "source": { "provider": "github-claude-commands", "repository": "https://github.com/sympotalk/SympotalkLauncher-APK", "path": ".claude/commands/rollback.md", "ref": "d0e3d97c352d308ecfdafe6b83a5868230c22603", "url": "https://github.com/sympotalk/SympotalkLauncher-APK/blob/d0e3d97c352d308ecfdafe6b83a5868230c22603/.claude/commands/rollback.md", "key": "sympotalk/SympotalkLauncher-APK/.claude/commands/rollback.md" } } }

rollback

About