[RELEASE] v2.2.9 도메인별 Claude Code rule 파일 세팅

[pooreumjung]

#️⃣ Issue Number

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

📝 요약(Summary)

💬 공유사항 to 리뷰어

✅ 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!

This pull request introduces a structured set of rule files for Claude Code, aimed at providing better context for AI agents regarding the project's architecture, domain-specific conventions, and known issues. By documenting these patterns, the PR ensures that future development and AI-assisted tasks remain consistent with existing business logic and technical constraints.

Highlights

• Claude Code Rules Configuration: Added a comprehensive set of domain-specific rule files in the .claude/rules/ directory to provide context for AI-assisted development, covering domains like admin, auth, menu, review, and more.
• Documentation Update: Updated CLAUDE.md to accurately reflect the current state of the admin domain, clarifying that it functions as a JSON API rather than a Mustache-based UI.

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.

---

Rules defined in files so clear, / To guide the code and calm the fear. / With domains mapped and logic set, / The best of builds we'll surely get.

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

이번 풀이 리퀘스트는 프로젝트의 각 도메인별 제약 사항과 컨벤션을 정리한 Claude 규칙 파일들(.claude/rules/*.md)을 추가하고 CLAUDE.md를 업데이트하여 AI 어시스턴트의 개발 맥락을 보완합니다. 리뷰어는 report.md, inquiry.md, rating.md 규칙 파일의 paths 설정에 타 도메인 패키지에 위치한 연관 파일 경로(예: Report.java, ManageInquiryService.java, rating calculator 클래스들)를 추가하여, Claude가 해당 파일들을 수정할 때도 관련 규칙을 누락 없이 인지할 수 있도록 개선할 것을 제안했습니다.

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.

[gemini-code-assist]

Report 엔티티(Report.java)는 ssu/eatssu/domain/review/entity/Report.java 경로에 위치해 있습니다. 현재 설정된 paths 필터(src/main/java/ssu/eatssu/domain/report/**/*.java)만으로는 Claude가 Report 엔티티 파일을 직접 수정할 때 이 규칙 파일(report.md)을 로드하지 못하게 됩니다. 따라서 paths 목록에 Report.java 경로를 추가하여 Claude가 엔티티를 수정할 때도 관련 규칙을 인지할 수 있도록 개선하는 것이 좋습니다.

Suggested change

	paths:
	- "src/main/java/ssu/eatssu/domain/report/**/*.java"
	paths:
	- "src/main/java/ssu/eatssu/domain/report/**/*.java"
	- "src/main/java/ssu/eatssu/domain/review/entity/Report.java"

[gemini-code-assist]

규칙 설명에 언급된 것처럼 문의 상태(InquiryStatus) 전이 로직은 ssu/eatssu/domain/admin/service/ManageInquiryService.java에서 처리됩니다. Claude가 해당 어드민 서비스를 수정할 때 이 규칙을 놓치지 않도록 paths 목록에 ManageInquiryService.java 경로를 추가하는 것이 좋습니다.

Suggested change

	paths:
	- "src/main/java/ssu/eatssu/domain/inquiry/**/*.java"
	paths:
	- "src/main/java/ssu/eatssu/domain/inquiry/**/*.java"
	- "src/main/java/ssu/eatssu/domain/admin/service/ManageInquiryService.java"

[gemini-code-assist]

실제 별점 집계가 이루어지는 핵심 구현체인 QuerydslMealRatingCalculator와 QuerydslMenuRatingCalculator는 ssu/eatssu/domain/menu/persistence/ 패키지에 위치해 있습니다. Claude가 이 계산기 클래스들을 수정할 때 별점 집계 관련 규칙을 참고할 수 있도록 paths 목록에 해당 경로를 추가하는 것이 좋습니다.

Suggested change

	paths:
	- "src/main/java/ssu/eatssu/domain/rating/**/*.java"
	paths:
	- "src/main/java/ssu/eatssu/domain/rating/**/*.java"
	- "src/main/java/ssu/eatssu/domain/menu/persistence/*RatingCalculator.java"