Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions .claude/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Claude AI 협업 가이드

이 디렉토리는 Claude Code와의 협업을 위한 규칙과 컨텍스트를 포함합니다.

## 핵심 원칙

### Claude 역할 제한
- **허용**: 제안, 대안 제시, 승인된 범위 내 구현
- **금지**: 임의 설계 결정, 요구사항 확장, 테스트 삭제/약화

### TDD Workflow (필수)
1. 🔴 **Red**: 실패하는 테스트 먼저 작성 (로직 구현 금지)
2. 🟢 **Green**: 테스트 통과하는 최소 코드만 작성
3. 🔵 **Refactor**: 동작 변경 없이 품질 개선 (새 기능 추가 금지)

## 참고 문서

| 문서 | 내용 |
|------|------|
| **CLAUDE.md** | 전체 개발 가이드 (기술 스택, 아키텍처, 컨벤션, 테스트 전략) |
| **.codeguide/loopers-1-week.md** | Week 1 구현 요구사항 |

## Week 1 범위 (Member 도메인)

- 회원가입 (`POST /api/v1/members/register`)
- 내 정보 조회 (`GET /api/v1/members/me`)
- 비밀번호 수정 (`PATCH /api/v1/members/me/password`)
Comment on lines +25 to +27
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

문서의 엔드포인트 경로가 실제 구현과 불일치합니다.

README에서는 /api/v1/members/... 경로를 사용하지만, PR 목표와 실제 구현에서는 /api/v1/users/... 경로를 사용합니다. Claude AI가 이 문서를 참고할 때 혼동이 발생할 수 있습니다.

📝 수정 제안
-- 회원가입 (`POST /api/v1/members/register`)
-- 내 정보 조회 (`GET /api/v1/members/me`)
-- 비밀번호 수정 (`PATCH /api/v1/members/me/password`)
+- 회원가입 (`POST /api/v1/users/register`)
+- 내 정보 조회 (`GET /api/v1/users/me`)
+- 비밀번호 수정 (`PATCH /api/v1/users/me/password`)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- 회원가입 (`POST /api/v1/members/register`)
- 내 정보 조회 (`GET /api/v1/members/me`)
- 비밀번호 수정 (`PATCH /api/v1/members/me/password`)
- 회원가입 (`POST /api/v1/users/register`)
- 내 정보 조회 (`GET /api/v1/users/me`)
- 비밀번호 수정 (`PATCH /api/v1/users/me/password`)
🤖 Prompt for AI Agents
In @.claude/README.md around lines 25 - 27, README endpoints use
/api/v1/members/... but the implementation and PR use /api/v1/users/..., causing
mismatch; update the listed endpoints (회원가입, 내 정보 조회, 비밀번호 수정) to use
/api/v1/users/register, /api/v1/users/me, and /api/v1/users/me/password (or the
exact route names used by the UserController /users handlers) so the
documentation matches the actual routes referenced in the codebase.


## Never Do

- ❌ 테스트 삭제, @Disabled, assertion 약화
- ❌ 승인 없이 요구사항 확장/범위 초과
- ❌ Mock 데이터로만 동작하는 구현
- ❌ System.out.println 코드

## Priority

1. 실제 동작하는 코드
2. null-safety, thread-safety
3. 테스트 가능한 구조
4. 기존 패턴과 일관성 유지

---

**Last Updated**: 2026-02-04
7 changes: 7 additions & 0 deletions .claude/settings.local.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"permissions": {
"allow": [
"Bash(./gradlew:*)"
]
}
}
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,4 @@ out/

### Kotlin ###
.kotlin
nul
Loading