GulSam00 · GulSam00 · May 19, 2026 · Apr 19, 2026 · Apr 29, 2026 · Apr 29, 2026
diff --git a/.claude/commands/check-review.md b/.claude/commands/check-review.md
@@ -0,0 +1,115 @@
+# /check-review — Qodo Review Brief
+
+현재 브랜치의 PR에서 qodo-code-review 봇이 남긴 리뷰 코멘트를 읽고 이슈를 분류해 브리핑한다.
+
+## Input
+
+`$ARGUMENTS` — PR 번호 (선택). 생략하면 현재 브랜치의 PR을 자동으로 조회한다.
+
+예: `/check-review` 또는 `/check-review 232`
+
+## Steps
+
+1. PR 번호를 결정한다.
+
+   - `$ARGUMENTS` 가 있으면 해당 번호를 사용한다.
+   - 없으면 현재 브랜치에서 열린 PR을 조회한다.
+
+   ```
+   gh pr view --json number,title,url
+   ```
+
+   PR이 없으면 아래 메시지를 출력하고 중단한다.
+
+   ```
+   ⛔ 현재 브랜치에 열린 PR이 없습니다.
+   `/pr` 로 PR을 먼저 생성하거나, `/check-review <PR번호>` 로 직접 지정하세요.
+   ```
+
+2. 레포 오너와 이름을 확인한다.
+
+   ```
+   gh repo view --json owner,name
+   ```
+
+3. PR의 리뷰 코멘트를 가져온다.
+
+   `mcp__plugin_everything-claude-code_github__get_pull_request_comments` 도구를 사용한다.
+   - owner: 위에서 확인한 오너
+   - repo: 위에서 확인한 레포 이름
+   - pull_number: 위에서 결정한 PR 번호
+
+4. qodo-code-review 봇(`login`에 `qodo` 포함)의 코멘트만 필터링한다.
+
+   동일 이슈가 중복 언급된 경우(영/한 버전 등) 하나로 통합한다.
+   통합 기준: 같은 파일 + 같은 이슈 설명 유형. 한국어 버전 우선.
+
+5. 필터링된 코멘트를 아래 기준으로 분류한다.
+
+   | 태그 | 의미 |
+   | --- | --- |
+   | `🐞 Bug` | 런타임 버그, 크래시, 데이터 불일치 |
+   | `📎 Requirement gap` | API 계약/스펙 미준수 |
+   | `📘 Rule violation` | 프로젝트 규칙 위반 |
+   | `⚠️ Reliability` | 원자성, 동시성, 안정성 문제 |
+
+   우선순위: `🐞 Bug` > `📎 Requirement gap` > `📘 Rule violation` > `⚠️ Reliability`
+
+6. 아래 형식으로 브리핑을 출력한다.
+
+---
+
+## 📋 Qodo Review Brief — PR #<번호>
+
+> **<PR 제목>**
+
+총 **<N>개** 이슈 (중복 제거 후)
+
+---
+
+### 🐞 버그 (<n>건)
+
+**<번호>. <이슈 제목>** — `<파일 경로>`
+
+> <한 줄 요약>
+
+- **원인**: <원인 설명>
+- **권장 수정**: <수정 방향>
+
+---
+
+### 📎 Requirement Gap (<n>건)
+
+... (동일 형식)
+
+---
+
+### 📘 Rule Violation (<n>건)
+
+... (동일 형식)
+
+---
+
+### ✅ 조치 완료
+
+이미 현재 세션에서 수정한 이슈가 있으면 여기에 표시한다.
+파일 경로와 수정 내용을 기반으로 판단한다.
+
+---
+
+### 👉 다음 단계
+
+우선순위 순서로 대응할 이슈를 나열한다.
+
+| 우선순위 | 이슈 | 파일 |
+| --- | --- | --- |
+| 1 | <가장 중요한 이슈> | `<파일>` |
+| 2 | ... | ... |
+
+---
+
+## Notes
+
+- 코멘트가 없으면 "qodo-code-review 리뷰 코멘트가 없습니다." 를 출력하고 종료한다.
+- 중복 코멘트(영/한 동일 이슈)는 하나로 통합한다.
+- 이미 수정된 이슈는 "✅ 조치 완료" 섹션으로 분류한다.
diff --git a/.claude/commands/start.md b/.claude/commands/start.md
@@ -22,12 +22,23 @@
 
 2. GitHub Issue를 생성한다.
 
+   이슈 본문은 아래 구조로 작성한다:
+   - 작업 개요 설명 (1~3줄)
+   - `## 작업 체크리스트` 섹션: 구현할 항목을 GitHub Flavored Markdown checkbox(`- [ ]`)로 나열
+   - 완료된 항목은 `- [x]`로 표시 (이슈 생성 시점엔 모두 `- [ ]`)
+
    ```
    gh issue create --title "<이슈 제목>" --body "<이슈 본문>"
    ```
 
    생성된 이슈 번호를 추출한다.
 
+   작업이 진행되면서 항목이 완료될 때마다 아래 명령으로 이슈 본문을 갱신한다:
+
+   ```
+   gh issue edit <번호> --body "<갱신된 본문>"
+   ```
+
 3. develop 브랜치를 최신으로 갱신한다.
 
    ```

diff --git a/.claude/settings.json b/.claude/settings.json
@@ -1,4 +1,8 @@
 {
+  "permissions": {
+    "defaultMode": "bypassPermissions"
+  },
+
   "hooks": {
     "SessionStart": [
       {

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -35,7 +35,7 @@ No test suite is configured.
 ```
 apps/
   web/      — Next.js 15 web app (primary app, see apps/web/CLAUDE.md)
-  mobile/   — Expo React Native app (early stage)
+  mobile/   — [DEPRECATED — frozen, see apps/mobile/README.md] Expo wrapper app, replaced by TWA approach. Excluded from pnpm workspace.
 packages/
   open-api/ — Wrapper around the external karaoke open API (@repo/open-api)
   query/    — Shared TanStack Query hooks for open-api (@repo/query)
@@ -76,12 +76,15 @@ See [apps/web/CLAUDE.md](apps/web/CLAUDE.md) for full detail. Key points:
 | `/green`    | 구현 코드 작성                           | 필수      |
 | `/refactor` | 코드 품질 개선 (동작 변경 X)             | 생략 가능 |
 | `/verify`   | build, lint, format, test 전체 검증      | **필수**  |
-| `/commit`   | 커밋 메시지 생성 및 커밋                 | **필수**  |
+| `/commit`        | 커밋 메시지 생성 및 커밋                 | **필수**  |
+| `/pr`            | PR 생성 및 Qodo AI 리뷰 요청            | 권장      |
+| `/check-review`  | Qodo 리뷰 코멘트 읽기 및 이슈 브리핑    | 권장      |
 
 ### 단축 사이클
 
 - 긴급 핫픽스: `/start` → `/spsc` → `/green` → `/verify` → `/commit`
 - `/red` ~ `/refactor` 는 상황에 따라 생략 가능하나, `/verify` → `/commit` 은 항상 실행한다.
+- PR 생성 후: `/pr` → `/review-brief` 로 리뷰 이슈를 확인한다.
 
 ## Git Conventions
 

diff --git a/apps/mobile/README.md b/apps/mobile/README.md
@@ -1,50 +1,34 @@
-# Welcome to your Expo app 👋
+# apps/mobile (DEPRECATED — Frozen)
 
-This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
+> **이 워크스페이스는 동결되었습니다.** 활성 개발은 `apps/twa`에서 진행됩니다.
 
-## Get started
+## 동결 사유
 
-1. Install dependencies
+- 본 앱은 `singcode.kr`을 `react-native-webview`로 래핑한 wrapper 앱입니다 (PR #203).
+- [Google Play Minimum Functionality 정책](https://support.google.com/googleplay/android-developer/answer/9888379)상 단순 웹사이트 래퍼는 스토어 거절 위험이 큽니다.
+- 대안으로 **TWA (Trusted Web Activity)** 방식을 채택했습니다. TWA는 Expo/RN 코드와 무관하므로 본 워크스페이스를 동결합니다.
+- 미래에 PWA로 해결할 수 없는 네이티브 기능(생체 인증, 백그라운드 위치, 인앱 결제 등)이 필요해질 경우를 대비해 코드는 보존합니다.
 
-   ```bash
-   npm install
-   ```
+## 동결 상태
 
-2. Start the app
+- **Expo SDK**: 52
+- **React / React Native**: 18.3.1 / 0.76.7
+- **마지막 활성 PR**: [#203 — WebView로 singcode.kr 표시 구현](https://github.com/GulSam00/singcode/pull/203)
+- **동결 이슈**: #204
+- pnpm 워크스페이스에서 제외됨 (`pnpm-workspace.yaml`의 `'!apps/mobile'`)
+- `pnpm install`, `pnpm build`, `pnpm lint`, `pnpm check-types` 대상에서 자동 제외
 
-   ```bash
-    npx expo start
-   ```
+## 재활성화 절차
 
-In the output, you'll find options to open the app in a
+이 앱을 다시 활용해야 한다면:
 
-- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
-- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
-- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
-- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+1. `pnpm-workspace.yaml`에서 `'!apps/mobile'` 한 줄 제거
+2. 레포 루트에서 `pnpm install` 실행
+3. `apps/mobile/`에서 `pnpm start` (또는 `pnpm android` / `pnpm ios`)
 
-You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+> Expo SDK 52는 시간이 지나면서 deprecate됩니다. 재활성화 시점에는 SDK 업그레이드와 `package.json` 의존성 재정비가 선행되어야 할 수 있습니다.
 
-## Get a fresh project
+## 후속 작업
 
-When you're ready, run:
-
-```bash
-npm run reset-project
-```
-
-This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
-
-## Learn more
-
-To learn more about developing your project with Expo, look at the following resources:
-
-- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
-- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
-
-## Join the community
-
-Join our community of developers creating universal apps.
-
-- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
-- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.
+- 신규 워크스페이스: `apps/twa` (별도 이슈로 진행)
+- `apps/web` PWA 셋업: manifest, Service Worker, `.well-known/assetlinks.json`
diff --git a/apps/mobile/package.json b/apps/mobile/package.json
@@ -1,5 +1,6 @@
 {
-  "name": "mobile",
+  "name": "mobile-deprecated",
+  "description": "DEPRECATED — frozen at Expo SDK 52. Replaced by apps/twa. See apps/mobile/README.md.",
   "main": "expo-router/entry",
   "version": "1.0.0",
   "scripts": {

diff --git a/apps/twa/.gitignore b/apps/twa/.gitignore
@@ -0,0 +1,9 @@
+# Android keystore — 외부 백업 필수, git에 절대 커밋하지 않는다
+*.keystore
+*.jks
+
+# Bubblewrap 빌드 산출물
+android/
+output/
+*.aab
+*.apk