myListBridgeAPI/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Language Preference

IMPORTANT: Always communicate with the user in Korean (한국어) unless explicitly asked otherwise.

기술 스택

• JAVA: 17
• SpringBoot: 3.0
• Gradle

개발 규칙

1. 코드 작성 규칙

• 절대 모킹하지 않기: 실제 동작하는 코드만 작성
• 타입 안정성: TypeScript 엄격 모드 준수
• 테스트 우선: 테스트 커버리지 90% 이상 유지
• 컴포넌트 네이밍: PascalCase, 기능을 명확히 나타내는 이름 사용

2. 패키지 버전 호환성

• 새 패키지 추가 시 기존 의존성과 충돌 확인

3. 파일 구조 규칙

• index.js로 export 모듈화
• .unit.spec.tsx 확장자로 단위 테스트 작성
• .types.ts, .constants.ts, .utils.ts 분리

4. 스크립트 명령어

특별 주의사항

1. 절대 하지 말 것

• Mock 데이터나 가짜 구현 사용
• 타입 any 사용
• 직접적인 DOM 조작
• console.log 프로덕션 코드에 남기기

2. 권장사항

• 실제 API 호출하는 코드 작성
• 재사용 가능한 컴포넌트 설계
• 접근성 고려
• 성능 최적화 적용

3. 문제 해결 우선순위

1. 실제 동작하는 해결책 찾기
2. 기존 코드 패턴 분석 후 일관성 유지
3. 타입 안정성 보장
4. 테스트 가능한 구조로 설계