feat: claude.md 파일 추가

[Gyuhyeok99]

관련 이슈

• resolves: feat: claude code 도입 #550

작업 내용

claude.md파일을 추가했습니다! 이거를 앞으로 꾸준히 발전시켜나가면 단순한 기능들은 간편하게 코드를 작성할 수 있을 거 같습니다!
다들 앞으로 열심히 작성해나가봐요!
이 다음 pr로 어드민 지역 관련 curd pr을 올릴건데 이 md파일 기반으로 제가 작성한 거 없이 코드 작성, 테스트코드 작성, 커밋메시지 작성까지 맡겨봤습니다.
아직 좀 손볼 것이 많고 부족한 부분도 보이는데 그래도 확실히 생산성이 높아진 거 같네요!

특이 사항

리뷰 요구사항 (선택)

[coderabbitai]

구성 검토 요약

워크스루

solid-connect-server 프로젝트를 위한 Claude Code 레퍼런스 문서인 CLAUDE.md 파일이 저장소 루트에 새로 추가되었습니다. 다음과 같은 내용들이 포함되어 있습니다:

1. 프로젝트 기초 정보 — 사용 언어, 프레임워크, 빌드 도구, 데이터베이스, 마이그레이션 정보
2. 빌드 및 실행 가이드 — Gradle 명령어, 테스트 실행, bootRun, Docker를 통한 로컬 서비스 구성
3. 프로젝트 구조 및 아키텍처 — 계층형 아키텍처, 각 계층의 책임 사항, 패키지 레이아웃
4. 개발 규칙 — 코드 스타일, 명명 규칙, API 엔드포인트 네이밍 컨벤션
5. 기술 스택 — 핵심 프레임워크, 데이터베이스, 모니터링, 개발 도구
6. 테스트 가이드 — 설정, 픽스처, 테스트 패턴, BDD 및 중첩 테스트, 어서션
7. Git 커밋 규칙 — 커밋 메시지 컨벤션
8. Flyway 마이그레이션 — 위치, 파일 네이밍, 프로세스, 주의사항
9. 데이터베이스 접근 패턴 — JPA 엔티티 및 레포지토리 예제
10. 기타 — 주요 파일 위치, 프로필, 자주 하는 작업, 참고 자료

이 변경사항은 순수하게 문서 기반이며 실행 가능한 로직이나 런타임 변경사항을 포함하지 않습니다.

예상 코드 리뷰 소요 시간

🎯 1 (Trivial) | ⏱️ ~3분

• 단일 문서 파일 추가로 일관성 있는 변경
• 문서적 성격으로 로직 검증 불필요
• 구조와 형식, 정보 정확성 확인만 필요

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Linked Issues check	❓ Inconclusive	연결된 이슈 #550은 구체적인 요구사항 없이 TODO 항목만 포함되어 있어, 명확한 달성 기준 평가가 불가능합니다.	이슈 #550의 TODO 항목을 구체적으로 명시하고 PR이 해당 요구사항을 충족하는지 확인하세요.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 제목은 추가된 claude.md 파일의 생성을 명확하게 설명하고 있어 변경사항의 핵심을 잘 요약하고 있습니다.
Description check	✅ Passed	관련 이슈와 작업 내용이 작성되었으나, 특이사항과 리뷰 요구사항 섹션은 완성되지 않아 템플릿을 완전히 따르지 않았습니다.
Out of Scope Changes check	✅ Passed	claude.md는 순수 문서 파일로, 기술 스택 안내, 개발 규칙, 테스트 가이드 등 프로젝트 참고용 콘텐츠만 포함하고 있습니다.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (2)

claude.md (2)

56-56: 1. 코드 블록에 언어 지정자 추가

마크다운 린팅 규칙에 따라, 몇 개의 코드 블록에서 언어 지정자가 누락되어 있습니다. 다음 위치의 코드 블록들을 수정해주세요:

• Line 56: 트리 구조 → 지정자 없음 (또는 text/plaintext 사용)
• Line 95: 계층 다이어그램 → 지정자 없음 (또는 plaintext 사용)
• Line 116: 패키지 구조 → 지정자 없음 (또는 plaintext 사용)
• Line 223: Fixture 디렉토리 구조 → 지정자 없음 (또는 plaintext 사용)
• Line 448: Git 커밋 형식 → text 또는 plaintext 지정자 추가
• Line 456: Type 목록 → text 또는 plaintext 지정자 추가
• Line 497: 파일명 형식 → 지정자 없음 (또는 plaintext 사용)

예: ```plaintext 또는 해당하는 언어(예: ```java, ```bash, ```sql)

[MD040, fenced-code-language]

Also applies to: 95-95, 116-116, 223-223, 448-448, 456-456, 497-497

---

603-608: 2. URL을 마크다운 링크 형식으로 변경

현재 참고 자료 섹션(Lines 603-608)의 URL들이 문자 그대로 입력되어 있습니다. 마크다운 모범 사례에 따라 다음과 같이 수정해주세요:

- **개발 컨벤션**: [개발-컨벤션-정리](https://github.com/solid-connection/solid-connect-server/wiki/개발-컨벤션-정리)
- **테스트 가이드**: `test.md` 파일 참고
- **Spring Boot**: [Spring Boot](https://spring.io/projects/spring-boot)
- **JPA**: [Spring Data JPA](https://spring.io/projects/spring-data-jpa)
- **TestContainers**: [TestContainers](https://www.testcontainers.org/)
- **Flyway**: [Flyway](https://flywaydb.org/)

이렇게 하면 마크다운이 더 깔끔하게 렌더링되고, 문서 가독성이 향상됩니다.

[MD034, no-bare-urls]

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8de1c80 and 5e08daf.

📒 Files selected for processing (1)

• claude.md (1 hunks)

🧰 Additional context used

🪛 markdownlint-cli2 (0.18.1)

claude.md

56-56: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

95-95: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

116-116: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

223-223: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

448-448: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

456-456: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

497-497: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

---

603-603: Bare URL used

(MD034, no-bare-urls)

---

605-605: Bare URL used

(MD034, no-bare-urls)

---

606-606: Bare URL used

(MD034, no-bare-urls)

---

607-607: Bare URL used

(MD034, no-bare-urls)

---

608-608: Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (1)

claude.md (1)

1-619: 3. 문서 전체: 우수한 구조와 완성도

전체적으로 이 가이드는 매우 잘 구성되었습니다! 다음 점들이 특히 돋보입니다:

• ✅ 명확한 섹션 구조: 프로젝트 개요부터 주의사항까지 논리적 흐름
• ✅ 실용적 예제: Fixture 패턴, BDD 테스트, 커밋 컨벤션 등 코드 예제 포함
• ✅ 검색 가능한 포맷: 테이블, 코드 블록, 마크다운 형식으로 스캔하기 쉬움
• ✅ 한국어 네이밍 컨벤션 설명: 테스트 가독성 향상을 위한 실용적 가이드
• ✅ 개발자 경험 개선: 마이그레이션 주의사항, 환경별 프로필 등 실무 팁

Claude Code와 개발팀이 이 문서를 통해 빠르고 일관성 있게 기능을 구현할 수 있을 것 같습니다. 위의 두 가지 포맷팅 사항만 해결되면 준비 완료입니다!

[Hexeong]

LGTM~ 좋습니당