docs: 도메인별 Claude Code rule 파일 세팅

[pooreumjung]

#️⃣ Issue Number

• resolved feature: 도메인별 Claude Code rule 파일 세팅 #400

📝 요약(Summary)

• .claude/rules/에 도메인별 rule 파일 12개(auth, menu, review, rating, user, partnership, admin, inquiry, report, restaurant, slack, slice)를 추가했습니다. 기존 persistence.md/testing.md/commenting.md와 동일하게 paths: frontmatter로 해당 도메인 경로에만 적용되도록 스코프를 제한했습니다.
• 공통 패턴(BaseResponse, BaseException/BaseResponseStatus, Localizable 등)은 이미 최상위 CLAUDE.md에 있으므로 중복 기재하지 않았고, 각 도메인 rule에는 해당 도메인에서만 통하는 설계/구조적 특이사항만 담았습니다.
• 도메인 탐색 과정에서 CLAUDE.md의 admin 설명("Mustache 템플릿 기반 어드민 UI")이 실제 구현과 다르다는 것을 확인해 함께 수정했습니다. 실제로는 spring-boot-starter-mustache 의존성 자체가 없고 모든 admin 컨트롤러가 @ResponseBody JSON API입니다.

💬 공유사항 to 리뷰어

• 각 rule 파일 내용은 12개 도메인 패키지를 병렬로 탐색한 결과에서 "앞으로 코드 작성 시 계속 알아야 할 구조적 특성"만 추린 것입니다. 탐색 중 발견된 명확한 버그성 항목들(총 12건: 이 브랜치와 별도로 #401은 이미 수정 PR 올렸고, 나머지 11건은 #403~#413으로 개별 이슈만 등록해뒀습니다)은 이번 PR 범위에 포함하지 않았습니다.
• 코드 동작 변경이 없는 문서 전용 PR이라 별도 테스트는 하지 않았습니다. rule 파일 내용 중 사실과 다르거나 과장된 부분이 있으면 지적 부탁드립니다.

✅ PR Checklist

PR이 다음 요구 사항을 충족하는지 확인하세요.

• 커밋 메시지 컨벤션에 맞게 작성했습니다.
• 변경 사항에 대한 테스트를 했습니다.(버그 수정/기능에 대한 테스트).

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

본 PR은 프로젝트의 도메인별 코드 구조와 설계 컨벤션을 Claude Code가 더 정확하게 이해하고 활용할 수 있도록 돕기 위한 문서화 작업입니다. 각 도메인 패키지의 구조적 특성, 데이터 처리 방식, 그리고 주의해야 할 기술적 제약 사항들을 규칙 파일로 정리하여 향후 코드 작성 시 발생할 수 있는 실수를 방지하고 일관성을 유지하고자 합니다.

Highlights

• 도메인별 Claude Code 규칙 추가: .claude/rules/ 디렉토리에 12개 도메인(auth, menu, review, rating, user, partnership, admin, inquiry, report, restaurant, slack, slice)별로 상세 규칙 파일을 생성하여 각 도메인의 설계 특이사항과 주의점을 명시했습니다.
• CLAUDE.md 문서 현행화: admin 도메인에 대한 설명이 실제 구현(Mustache 템플릿 미사용, JSON API 기반)과 일치하도록 CLAUDE.md를 수정했습니다.

New Features

🧠 You can now enable Memory (public preview) to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

---

도메인마다 규칙을 적어, Claude가 길을 잃지 않게, 구조의 비밀을 문서에 담아, 코드의 질서를 세우네.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

이번 풀 리퀘스트에서는 프로젝트의 각 도메인(admin, auth, inquiry, menu, partnership, rating, report, restaurant, review, slack, slice, user)에 대한 설계 규칙과 주의사항을 정리한 Claude 룰 파일들을 추가하고, CLAUDE.md 내의 admin 패키지 설명을 최신 구현에 맞게 수정하였습니다. 제공된 리뷰어 피드백이 없으므로 추가적인 피드백은 없습니다.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.