From 56d225d1b2f6f59b7dfa3a227c751610847da6ea Mon Sep 17 00:00:00 2001
From: htlee <htlee@gcsc.co.kr>
Date: Mon, 23 Mar 2026 13:52:41 +0900
Subject: [PATCH] =?UTF-8?q?chore:=20=ED=8C=80=20=EC=9B=8C=ED=81=AC?=
 =?UTF-8?q?=ED=94=8C=EB=A1=9C=EC=9A=B0=20=EB=B6=80=ED=8A=B8=EC=8A=A4?=
 =?UTF-8?q?=ED=8A=B8=EB=9E=A9=20-=20CLAUDE.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CLAUDE.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..3bcad04
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,65 @@
+# 프로젝트 개요
+
+- **타입**: Java + Spring Boot + Maven
+- **JDK**: 17 (`.sdkmanrc` 참조)
+- **프레임워크**: Spring Boot
+- **빌드 도구**: Maven (Maven Wrapper 사용)
+
+## 빌드 및 실행
+
+```bash
+# 빌드
+./mvnw clean compile
+
+# 패키징
+./mvnw clean package -DskipTests
+
+# 테스트
+./mvnw test
+
+# 특정 테스트 클래스 실행
+./mvnw test -Dtest=클래스명
+
+# 로컬 실행
+./mvnw spring-boot:run
+
+# 린트 (Checkstyle 설정된 경우)
+./mvnw checkstyle:check
+```
+
+## 프로젝트 구조
+
+```
+src/
+├── main/
+│   ├── java/
+│   │   └── com/gcsc/{프로젝트}/
+│   │       ├── config/          # 설정 클래스
+│   │       ├── controller/      # REST 컨트롤러
+│   │       ├── service/         # 비즈니스 로직
+│   │       ├── repository/      # 데이터 접근
+│   │       ├── domain/          # 엔티티
+│   │       ├── dto/             # 데이터 전송 객체
+│   │       ├── exception/       # 예외 처리
+│   │       └── util/            # 유틸리티
+│   └── resources/
+│       ├── application.yml      # 공통 설정
+│       ├── application-local.yml # 로컬 설정 (.gitignore)
+│       └── application-prod.yml  # 운영 설정
+└── test/
+    └── java/                    # 테스트 코드
+```
+
+## 팀 규칙
+
+- 코드 스타일: `.claude/rules/code-style.md` 참조
+- 네이밍 규칙: `.claude/rules/naming.md` 참조
+- 테스트 규칙: `.claude/rules/testing.md` 참조
+- Git 워크플로우: `.claude/rules/git-workflow.md` 참조
+- 팀 정책: `.claude/rules/team-policy.md` 참조
+
+## 의존성 관리
+
+- Nexus 프록시 레포지토리를 통해 의존성 관리 (`.mvn/settings.xml`)
+- 새 의존성 추가 시 `pom.xml`에 버전 명시
+- Spring Boot BOM 범위 내 의존성은 버전 생략 가능