chore: Claude Code 문서 개선

.claude/rules/code-style.md

@@ -0,0 +1,23 @@
+---
+paths:
+  - "src/**/*.java"
+---
+
+# Code Style
+
+## Naming
+- DTO factory: `of(A, B)` for multiple params / `from(X)` for single param
+- Request/Response classes: `XxxRequest`, `XxxResponse`
+- REST endpoints: kebab-case only (`/user-profile`, NOT `/userProfile`)
+
+## Formatting
+- Blank line before every class declaration
+- Newline at end of every file
+- No wildcard imports
+- Controller method params: always on separate lines
+- 3+ params anywhere: always on separate lines
+- Private methods: placed immediately below the public method that calls them
+
+## Types
+- Non-null: primitives (`int`, `long`, `boolean`)
+- Nullable: wrapper types (`Integer`, `Long`, `Boolean`)

.claude/rules/database.md

@@ -0,0 +1,37 @@
+---
+paths:
+  - "src/main/java/**/domain/*.java"
+  - "src/main/resources/db/migration/*.sql"
+---
+
+# Database
+
+## JPA Entity
+
+- Every field requires `@Column(name = "...", nullable = ...)`
+- Field name must match DB column name exactly (snake_case)
+- `@Table(name = "...")` required on every entity class
+
+```java
+@Entity
+@Table(name = "chat_room")
+public class ChatRoom {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "id")
+    private Long id;
+
+    @Column(name = "is_group", nullable = false)
+    private boolean isGroup;
+
+    @Column(name = "mentoring_id", nullable = true)
+    private Long mentoringId;
+}
+```
+
+## Flyway
+
+- Location: `src/main/resources/db/migration/`
+- Naming: `V{VERSION}__{DESCRIPTION}.sql` (double underscore)
+- NEVER modify a deployed migration — always create a new version

.claude/rules/testing.md

@@ -0,0 +1,46 @@
+---
+paths:
+  - "src/test/**/*.java"
+---
+
+# Testing
+
+Base annotation: `@TestContainerSpringBootTest` for all integration tests.
+
+## Test data — Fixture pattern
+
+```java
+@TestComponent
+@RequiredArgsConstructor
+public class ChatRoomFixture {
+    private final ChatRoomFixtureBuilder chatRoomFixtureBuilder;
+
+    public ChatRoom 채팅방(boolean isGroup) { ... }        // Korean method names
+    public ChatRoom 멘토링_채팅방(long mentoringId) { ... }
+}
+```
+
+## Test class structure
+
+```java
+@TestContainerSpringBootTest
+@DisplayName("XXX 서비스 테스트")
+class XxxServiceTest {
+
+    @Nested
+    class 기능명 {
+
+        @Test
+        void 한국어_메서드명() {
+            // given
+            // when
+            // then
+        }
+    }
+}
+```
+
+- `@Nested` for grouping by feature
+- Korean names on `@Nested` classes and `@Test` methods
+- Given-When-Then with inline comments
+- Tests are independent — no shared state across tests

.claude/settings.json

@@ -1,29 +1,5 @@
 {
   "env": {
     "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
-  },
-  "hooks": {
-    "Notification": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python3 .claude/hooks/notify.py 2>/dev/null || python .claude/hooks/notify.py"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python3 .claude/hooks/post-edit-check.py 2>/dev/null || python .claude/hooks/post-edit-check.py"
-          }
-        ]
-      }
-    ]
   }
 }