frogger: Command for Claude Code

/pr-ready — PR 제출 전 최종 검증 + PR 제목 추천 + PR Body 생성

목적

PR을 올리기 전에 lint, type check, build를 한 번에 돌리고, PR 본문까지 생성한다.

입력

• $ARGUMENTS — (선택) base 브랜치 지정 (기본값: main)

실행 절차

1. 사전 상태 확인 (병렬 실행):

   • git status로 uncommitted 변경 확인 — 있으면 /commit으로 먼저 정리할 것을 안내하고 중단
   • git log $BASE..HEAD --oneline으로 커밋 목록 수집

2. 품질 게이트 (순차 실행, 하나라도 실패하면 중단):

   Step 1: npx tsc --noEmit          → 타입 체크
   Step 2: npm run build              → 빌드
   Step 3: 프롬프트 변경 감지 시 /prompt-diff 실행 → 프롬프트 계약 검증
   

   • 빌드 완료 후 git checkout next-env.d.ts로 빌드가 덮어쓴 변경을 되돌린다.
   • 각 단계 결과를 PASS/FAIL로 기록한다.
   • FAIL 발생 시 에러 내용을 출력하고, 수정 제안을 제공한다.
   • Step 4는 git diff $BASE...HEAD --name-only에 api/analyze/route.ts가 포함된 경우에만 실행한다. 해당 파일 변경이 없으면 SKIP 처리한다.
   • 모든 단계 PASS 시에만 다음으로 진행한다.

3. 최종 보고:

   ┌─────────────────────────┐
   │ PR Ready Check          │
   ├─────────────┬───────────┤
   │ Type Check  │ ✅ PASS   │
   │ Build       │ ✅ PASS   │
   │ Prompt Diff │ ✅ PASS / ⏭ SKIP │
   ├─────────────┼───────────┤
   │ Status      │ 🚀 Ready  │
   └─────────────┴───────────┘
   

   • 모든 게이트 PASS 시에만 4-5단계로 진행한다.

4. PR 제목 추천:

   • 커밋 목록과 diff를 분석하여 PR 제목을 3개 추천한다.
   • 형식: type: 간결한 설명 (70자 이내)
   • type은 커밋 컨벤션 기준: feat, fix, refactor, chore, docs 등
   • 가장 핵심적인 변경을 대표하는 제목을 첫 번째로 제시한다.

5. PR Body 생성:

   • git log $BASE...HEAD --oneline으로 커밋 목록을 수집한다.
   • git diff $BASE...HEAD로 변경 내용을 분석한다.
   • 다음 형식으로 PR 본문을 출력한다:

   ## Summary
   - 이 PR이 해결하는 문제와 핵심 변경 사항 요약 (2-3줄)
   
   ## Changes
   - 파일/기능 단위로 구체적인 변경 내용 나열
   - `git diff --stat` 기준으로 주요 변경 파일 포함
   
   ## QA
   <!-- 기능 추가/변경 시 사용자 시나리오 기반 검증 항목 -->
   - [ ] {사용자 시나리오 1: 어떤 동작을 했을 때 어떤 결과가 나와야 하는지}
   - [ ] {사용자 시나리오 2}
   - [ ] 기존 기능 회귀 없음 확인
   
   ## Status
   - [x] 타입 체크 통과
   - [x] 빌드 통과
   - [ ] 테스트 추가/수정 (해당 시)
   <!-- 커밋 메시지 기반 작업 항목 -->
   - [x] {커밋 메시지 기반 작업 항목}
   
   ## Demo
   <!-- 데모 영상/스크린샷 링크 (해당 시) -->
   > 📎 데모 영상 링크를 여기에 첨부해주세요.
   

   • "Summary"는 커밋 메시지와 diff를 분석하여 핵심 변경을 요약한다.
   • "Changes"는 git diff --stat 기준 파일/기능 단위로 작성한다.
   • "QA"는 변경된 기능의 사용자 관점 시나리오를 작성한다.
   • "Status"의 작업 항목은 커밋 메시지에서 자동 추출한다.