Chore/168 improve workflow commands

.claude/commands/pr.md

@@ -10,6 +10,14 @@
    git branch --show-current
    ```
 
+   **브랜치가 `develop` 또는 `main` 인 경우 즉시 중단한다.**
+   아래 메시지를 출력하고 더 이상 진행하지 않는다.
+
+   ```
+   ⛔ `develop` / `main` 브랜치에서는 PR을 생성할 수 없습니다.
+   `/start <작업 설명>` 으로 이슈를 생성하고 작업 브랜치를 만들어 주세요.
+   ```
+
 2. 브랜치 이름에서 작업 유형과 이슈 번호를 추출한다.
    - 규칙: `<type>/<issue-number>-<camelCaseName>`
    - 예: `feat/42-addSearchFilter` → type=`feat`, issue=`42`

.claude/commands/start.md

@@ -11,6 +11,10 @@
 ## Steps
 
 1. `$ARGUMENTS` 를 분석해 아래 항목을 결정한다.
+
+   **`$ARGUMENTS` 가 비어 있는 경우:**
+   `git diff` 와 `git status` 로 현재 변경 사항을 파악하고,
+   변경 내용을 기반으로 작업 유형, 이슈 제목, 이슈 본문을 자동으로 결정한다.
    - **작업 유형**: `feat` | `fix` | `hotfix` | `chore` | `refactor` | `doc`
    - **이슈 제목**: 한국어, 간결하게
    - **이슈 본문**: 구현할 내용을 bullet으로 정리
@@ -51,17 +55,17 @@
 
 ### 👉 다음 단계
 
-| 명령어    | 설명                     |
-| --------- | ------------------------ |
-| `/spsc`   | 작업 범위 정의 (권장)    |
-| `/red`    | 테스트 먼저 작성         |
-| `/green`  | 바로 구현 시작           |
+| 명령어   | 설명                  |
+| -------- | --------------------- |
+| `/spsc`  | 작업 범위 정의 (권장) |
+| `/red`   | 테스트 먼저 작성      |
+| `/green` | 바로 구현 시작        |
 
 ### 🔄 워크플로우 사이클
 
 ```
-일반:  /start → /spsc → /red → /green → /refactor → /verify → /commit
-단축:  /start → /spsc → /green → /verify → /commit
+일반:  /start → /spsc → /red → /green → /refactor → /verify → /commit → /pr
+단축:  /start → /spsc → /green → /verify → /commit → /pr
 ```
 
 - `/red` ~ `/refactor` 사이클은 상황에 따라 생략 가능하다.
@@ -72,5 +76,5 @@
 
 ## Notes
 
-- `$ARGUMENTS` 가 비어 있으면 "작업 내용을 입력해주세요." 를 출력하고 중단한다.
+- `$ARGUMENTS` 가 비어 있으면 현재 변경 사항(`git diff`, `git status`)을 분석해 자동으로 판단한다.
 - 이슈 생성 실패 시 에러 메시지를 출력하고 중단한다.

.gitignore

@@ -48,4 +48,6 @@ yarn-error.log*
 # Claude Code local settings (contains secrets)
 
 temp/
-.vscode
+.vscode
+
+settings.local.json

apps/web/CLAUDE.md

@@ -25,6 +25,7 @@ No test suite is configured.
 ### Monorepo Structure
 
 This is a pnpm workspace monorepo. The web app lives at `apps/web/`. Key workspace packages:
+
 - `@repo/open-api` — wrapper around the external karaoke open API (used in API routes)
 - `@repo/query` — shared TanStack Query setup
 - `@repo/eslint-config`, `@repo/format-config` — shared tooling configs
@@ -49,6 +50,7 @@ This is a pnpm workspace monorepo. The web app lives at `apps/web/`. Key workspa
 ### Supabase Client Variants
 
 Three different Supabase clients for different contexts:
+
 - `src/lib/supabase/client.ts` — browser client (`createBrowserClient`), uses `NEXT_PUBLIC_` env vars
 - `src/lib/supabase/server.ts` — server/route handler client (`createServerClient`)
 - `src/lib/supabase/api.ts` — legacy API routes client (Next.js Pages-style `req/res`)
@@ -87,6 +89,7 @@ Song searches go through `GET /api/open_songs/[type]/[param]` which proxies to `
 ## Environment Variables
 
 Required in `.env` / `.env.development.local`:
+
 - `NEXT_PUBLIC_SUPABASE_URL`
 - `NEXT_PUBLIC_SUPABASE_ANON_KEY`
 - `SUPABASE_URL` (server-only, used in legacy API client)
@@ -99,12 +102,12 @@ Required in `.env` / `.env.development.local`:
 
 Format: `<type>/<camelCaseName>`
 
-| type | usage |
-|------|-------|
-| `feat` | new feature |
-| `fix` | bug fix |
-| `hotfix` | urgent fix |
-| `chore` | maintenance, docs, config |
+| type      | usage                          |
+| --------- | ------------------------------ |
+| `feat`    | new feature                    |
+| `fix`     | bug fix                        |
+| `hotfix`  | urgent fix                     |
+| `chore`   | maintenance, docs, config      |
 | `release` | release (e.g. `release/2.1.0`) |
 
 The part after the slash uses camelCase (e.g. `feat/scrollText`, `feat/FooterNavbar`, `fix/loginAuth`).
@@ -115,16 +118,17 @@ Branch flow: `feat/*` → `develop` → `main`
 
 Format: `<type> : <Korean description>` — one space before and after the colon.
 
-| type | usage |
-|------|-------|
-| `feat` | new feature |
-| `fix` | bug fix |
-| `hotfix` | urgent bug fix |
-| `chore` | version bump, config, format, cleanup |
-| `refactor` | refactoring |
-| `doc` | documentation |
+| type       | usage                                 |
+| ---------- | ------------------------------------- |
+| `feat`     | new feature                           |
+| `fix`      | bug fix                               |
+| `hotfix`   | urgent bug fix                        |
+| `chore`    | version bump, config, format, cleanup |
+| `refactor` | refactoring                           |
+| `doc`      | documentation                         |
 
 Examples:
+
 ```
 feat : MarqueeText 자동 스크롤 텍스트 적용
 fix : SongCard css 수정

apps/web/public/sitemap-0.xml

@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:mobile="http://www.google.com/schemas/sitemap-mobile/1.0" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
-<url><loc>https://www.singcode.kr</loc><lastmod>2026-03-02T07:59:31.054Z</lastmod><changefreq>weekly</changefreq><priority>0.7</priority></url>
+<url><loc>https://www.singcode.kr</loc><lastmod>2026-03-25T14:32:28.966Z</lastmod><changefreq>weekly</changefreq><priority>0.7</priority></url>
 </urlset>

packages/crawling/CLAUDE.md

@@ -13,7 +13,6 @@ pnpm ky-open       # Open API(금영)로 KY 번호 수집
 pnpm ky-youtube    # YouTube 크롤링으로 KY 번호 수집 + AI 검증
 pnpm ky-verify     # 기존 KY 번호의 실제 존재 여부 재검증 (체크포인트 지원)
 pnpm ky-update     # ky-youtube + ky-verify 병렬 실행
-pnpm trans         # 일본어 아티스트명 → 한국어 번역 후 DB 저장
 pnpm test          # vitest 실행
 pnpm lint          # ESLint
 ```
@@ -74,24 +73,14 @@ findKYByOpen.ts
   └─ 제목 + 아티스트 문자열 비교로 KY 번호 매칭
 ```
 
-**일본어 번역**
-
-```
-postTransDictionary.ts
-  └─ getSongsJpnDB()             # 일본어 포함된 곡 필터링
-  └─ transChatGPT()              # GPT-4-turbo로 아티스트명 번역
-  └─ postTransDictionariesDB()   # trans_dictionaries 테이블에 저장
-```
-
 ### 핵심 패턴: 진행 상태 저장 (체크포인트)
 
 장시간 실행되는 스크립트가 중단됐을 때 재시작하면 처음부터 다시 하지 않도록, `src/assets/`에 텍스트 파일로 진행 상태를 기록한다.
 
-| 파일                                      | 용도                               |
-| ----------------------------------------- | ---------------------------------- |
-| `src/assets/transList.txt`                | 이미 번역 시도한 일본어 아티스트명 |
-| `src/assets/crawlKYValidList.txt`         | 검증 완료된 (제목-아티스트) 쌍     |
-| `src/assets/crawlKYYoutubeFailedList.txt` | YouTube 크롤링 실패 목록           |
+| 파일                                      | 용도                           |
+| ----------------------------------------- | ------------------------------ |
+| `src/assets/crawlKYValidList.txt`         | 검증 완료된 (제목-아티스트) 쌍 |
+| `src/assets/crawlKYYoutubeFailedList.txt` | YouTube 크롤링 실패 목록       |
 
 `logData.ts`의 `save*` / `load*` 함수로 관리. 스크립트 시작 시 로드해 `Set`으로 변환 후 O(1) 검색으로 스킵 처리.
 
@@ -101,11 +90,10 @@ postTransDictionary.ts
 
 ### Supabase 테이블
 
-| 테이블               | 용도                             |
-| -------------------- | -------------------------------- |
-| `songs`              | 메인 곡 데이터 (TJ/KY 번호 포함) |
-| `invalid_ky_songs`   | KY 번호 수집 실패 목록           |
-| `trans_dictionaries` | 일본어 → 한국어 번역 사전        |
+| 테이블             | 용도                             |
+| ------------------ | -------------------------------- |
+| `songs`            | 메인 곡 데이터 (TJ/KY 번호 포함) |
+| `invalid_ky_songs` | KY 번호 수집 실패 목록           |
 
 ### AI 유틸
 

packages/crawling/eslint.config.mjs

@@ -0,0 +1,4 @@
+import { config } from '@repo/eslint-config/base';
+
+/** @type {import("eslint").Linter.Config} */
+export default config;

packages/crawling/package.json

@@ -11,9 +11,8 @@
     "ky-youtube": "tsx src/crawling/crawlYoutube.ts",
     "ky-verify": "tsx src/crawling/crawlYoutubeVerify.ts",
     "ky-update": "pnpm run ky-youtube & pnpm run ky-verify",
-    "trans": "tsx src/postTransDictionary.ts",
     "recent-tj": "tsx src/crawling/crawlRecentTJ.ts",
-    "lint": "eslint . --ext .ts,.js",
+    "lint": "eslint .",
     "test": "vitest run",
     "format": "prettier --write \"**/*.{ts,tsx,md}\""
   },

packages/crawling/src/crawling/crawlRecentTJ.ts

@@ -60,6 +60,4 @@ console.log('실패 개수 : ', result.failed.length);
 console.log('성공 데이터 : ', result.success);
 console.log('실패 데이터 : ', result.failed);
 
-
-
 await browser.close();

packages/crawling/src/crawling/replaceSupabaseFailed.ts

@@ -1,6 +1,7 @@
 import { getSongsKyNullDB } from '@/supabase/getDB';
 import { postInvalidKYSongsDB } from '@/supabase/postDB';
 import { Song } from '@/types';
+
 // import { loadCrawlYoutubeFailedKYSongs } from '@/utils/logData';
 
 const data: Song[] = await getSongsKyNullDB();

packages/crawling/src/findKYByOpen.ts

@@ -76,4 +76,3 @@ console.log(`
     - 성공: ${resultsLog.success.length}곡
     - 실패: ${resultsLog.failed.length}곡
   `);
-

packages/crawling/src/supabase/getDB.ts

@@ -1,4 +1,4 @@
-import { TransDictionary, TransSong } from '@/types';
+import { TransSong } from '@/types';
 import { containsJapanese } from '@/utils/parseString';
 
 import { getClient } from './getClient';
@@ -63,33 +63,6 @@ export async function getSongsKyNotNullDB(max: number = 50000) {
   return data;
 }
 
-export async function getTransDictionariesDB(): Promise<TransDictionary[]> {
-  const supabase = getClient();
-
-  // artist 정렬
-  const { data, error } = await supabase.from('trans_dictionaries').select('*');
-
-  if (error) throw error;
-
-  return data;
-}
-export async function getTransDictionariesDBByOriginal(
-  original: string,
-): Promise<TransDictionary | null> {
-  const supabase = getClient();
-
-  // artist 정렬
-  const { data, error } = await supabase
-    .from('trans_dictionaries')
-    .select('*')
-    .eq('original_japanese', original)
-    .limit(1);
-
-  if (error) throw error;
-
-  return data[0] ?? null;
-}
-
 export async function getInvalidKYSongsDB(): Promise<
   { id: string; title: string; artist: string }[]
 > {