49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# 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.
|
|
|
|
## 기술 스택
|
|
|
|
## 개발 규칙
|
|
|
|
### 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. 테스트 가능한 구조로 설계
|
|
|
|
|