chore: PR·코드리뷰·답글 한국어 작성 규칙 추가 및 PR 템플릿 준수 적용

Author: g-hyxn

.claude/commands/code-review.md

@@ -1,5 +1,9 @@
 Review the current branch changes against develop: $ARGUMENTS
 
+## Rules
+
+- **All review output must be written in Korean**
+
 ## Instructions
 
 1. Run `git diff develop...HEAD` to get the full diff
@@ -9,37 +13,38 @@ Review the current branch changes against develop: $ARGUMENTS
 
 ## Review Criteria
 
-### Must Check
-- **Bug risk**: null/undefined handling, async error handling, edge cases
-- **Security**: XSS, open redirect, sensitive data exposure, missing auth checks
-- **Type safety**: `any` usage, unsafe type assertions
+### 필수 확인
+- **버그 가능성**: null/undefined 처리, 비동기 에러 처리, 엣지 케이스
+- **보안**: XSS, 오픈 리다이렉트, 민감 정보 노출, 인증/인가 누락
+- **타입 안전성**: `any` 사용, 잘못된 타입 단언
 
-### Code Quality
-- **FSD compliance**: layer dependency direction must be `app` → `views` → `widgets` → `entities` → `shared`; reverse imports are forbidden
-- **Unnecessary complexity**: over-abstraction, dead code
-- **Duplication**: repeated logic that should be extracted
+### 코드 품질
+- **FSD 규칙 준수**: 레이어 의존성 방향 `app` → `views` → `widgets` → `entities` → `shared`, 역방향 참조 금지
+- **불필요한 복잡도**: 과도한 추상화, 사용되지 않는 코드
+- **중복**: 반복되는 로직
 
-### Tests
-- New logic should have corresponding tests
-- Tests should verify behavior, not implementation details
+### 테스트
+- 새 로직에 테스트가 있는지
+- 테스트가 구현 세부사항이 아닌 동작을 검증하는지
 
 ## Output Format
 
 ```
-## Code Review
+## 코드 리뷰
 
-### Must Fix
-- [file:line] issue and suggestion
+### 🚨 필수 수정
+- [파일명:라인] 문제점 및 제안
 
-### Recommended
-- [file:line] issue and suggestion
+### 💡 권장 개선
+- [파일명:라인] 문제점 및 제안
 
-### Optional
-- [file:line] comment or opinion
+### 🔍 확인 사항 (선택)
+- [파일명:라인] 의견
 
-### Good Parts
+### ✅ 잘된 점
 - ...
 ```
 
-- If no issues found, explicitly state "No issues"
-- Always include file path and line number for each item
+- 이슈가 없으면 해당 섹션 생략
+- 문제가 전혀 없으면 "이슈 없음" 명시
+- 각 항목에 파일 경로와 라인 번호 포함

.claude/commands/pr.md

@@ -1,10 +1,10 @@
 Draft and create a pull request based on the current branch: $ARGUMENTS
 
-## PR Rules
+## Rules
 
-- **Base branch**: `develop` (direct PR to `main` is forbidden)
-- **Title**: `[type] Brief description` format, under 70 chars
-- **Body**: Summary + Test plan sections are required
+- **All PR content must be written in Korean** (title, summary, work details, review notes)
+- **Base branch**: always `develop` (direct PR to `main` is forbidden)
+- **Must follow the project PR template** defined in `.github/PULL_REQUEST_TEMPLATE.md`
 - Merge only after CI passes
 
 ## Instructions
@@ -13,27 +13,42 @@ Draft and create a pull request based on the current branch: $ARGUMENTS
 
 1. Run `git log develop..HEAD` to get the commit list
 2. Run `git diff develop...HEAD` to understand all changes
-3. Draft the PR title and body
+3. Draft the PR title and body following the template below
 4. Confirm with the user, then run `gh pr create`
 
-## PR Body Template
+## PR Title Format
+
+```
+[type] 한국어로 간결하게 (70자 이내)
+```
+
+## PR Body Template (must follow exactly)
 
 ```markdown
-## Summary
-- (key changes as bullet points)
+## 💡 PR 요약
+
+> 해당 PR의 변경사항, 해당 이슈 등에 대한 간략한 설명을 작성해주세요.
+
+- {변경사항을 bullet point로 작성}
+
+## 📋 작업 내용
+
+> 해당 PR에서 작업한 내용을 자세히 설명해주세요.
+
+{구체적인 작업 내용 작성}
+
+## 🤝 리뷰 시 참고사항
 
-## Test plan
-- [ ] (test item 1)
-- [ ] (test item 2)
+> 리뷰어분들이 리뷰를 할 때 참고하면 좋을 사항이나 질문사항을 작성해주세요.
 
-🤖 Generated with [Claude Code](https://claude.com/claude-code)
+{참고사항이 없으면 이 섹션 삭제}
 ```
 
 ## Title Examples
 
 ```
-[feat] add validation to sign-in form
-[fix] prevent infinite redirect on token expiry
-[test] add auth unit tests
-[chore] add GitHub Actions CI configuration
+[feat] 로그인 폼 유효성 검사 추가
+[fix] 토큰 만료 시 무한 리다이렉트 수정
+[test] auth 관련 단위 테스트 추가
+[chore] GitHub Actions CI 설정 추가
 ```

.claude/commands/resolve.md

@@ -1,5 +1,10 @@
 Read all open PR review comments and post a reply to each thread: $ARGUMENTS
 
+## Rules
+
+- **All replies must be written in Korean**
+- Be concise and clear — include the commit hash when referencing a fix
+
 ## Instructions
 
 1. Accept a PR number as argument, or auto-detect from the current branch
@@ -13,22 +18,24 @@ Read all open PR review comments and post a reply to each thread: $ARGUMENTS
    ```
 
 3. Classify each comment into one of:
-   - **Done**: feedback already reflected in the code
-   - **Pending**: fix required — describe the approach
-   - **Skipped**: out of scope or disagreed — explain clearly with an alternative if available
+   - **반영 완료**: 이미 코드에 반영된 피드백
+   - **반영 예정**: 수정이 필요한 피드백
+   - **스킵**: 범위 밖이거나 동의하지 않는 피드백
 
 4. Post a reply to each comment thread
    ```bash
    gh api repos/{owner}/{repo}/pulls/comments/{comment_id}/replies \
-     -X POST -f body="<reply body>"
+     -X POST -f body="<한국어 답글>"
    ```
 
 ## Reply Guidelines
 
-- **Done**: describe what was changed + include the commit hash
-  - e.g. `Added clearAllCookies() helper and called it in beforeEach. (f812496)`
-- **Pending**: explain the planned fix and expected timing
-- **Skipped**: state the reason clearly; offer an alternative if applicable
+- **반영 완료**: 어떻게 수정했는지 + 커밋 해시 포함
+  - 예: "`clearAllCookies()` 헬퍼를 추가하고 `beforeEach`에서 호출하도록 수정했습니다. (f812496)"
+- **반영 예정**: 수정 방향과 이유 설명
+  - 예: "다음 커밋에서 `setLocationSearch()` 헬퍼로 추출하겠습니다."
+- **스킵**: 이유를 명확하게, 대안이 있으면 함께 제시
+  - 예: "해당 부분은 Next.js 빌드 산출물 수준으로 판단해 테스트 범위에서 제외했습니다."
 
 ## Usage