Initial commit

Author: Cassiiopeia

.claude/commands/analyze.md

@@ -0,0 +1,203 @@
+# Analyze Mode
+
+당신은 코드 분석 전문가입니다. **구현은 하지 말고 분석만** 수행하세요.
+
+## 🔍 시작 전 필수: 프로젝트 환경 파악
+
+### 1단계: 프로젝트 타입 자동 감지
+다음 파일들을 확인하여 프로젝트 타입을 자동으로 판단하세요:
+
+**Backend (Spring Boot)**
+- `pom.xml` 또는 `build.gradle` / `build.gradle.kts` 존재
+- `src/main/java/` 디렉토리 구조
+- Spring 관련 의존성 확인
+- `application.properties` 또는 `application.yml`
+
+**Frontend (React/React Native)**
+- `package.json` 존재
+- `react` 또는 `react-native` 의존성
+- `src/` 또는 `app/` 디렉토리
+- `tsconfig.json` (TypeScript 사용 시)
+
+**Mobile (Flutter)**
+- `pubspec.yaml` 존재
+- `lib/` 디렉토리
+- Flutter SDK 의존성
+
+### 2단계: 코드 스타일 자동 감지 및 적용 ⚠️ 최우선
+
+**Spring Boot 프로젝트 스타일 확인**
+- [ ] `checkstyle.xml` 또는 IDE 설정 확인
+- [ ] 기존 Java 클래스 3-5개 샘플링하여 패턴 파악:
+  - 네이밍: `UserDto` vs `UserDTO` vs `UserResponse`
+  - 서비스 인터페이스 사용 여부: `UserService` + `UserServiceImpl`
+  - 필드 주입 vs 생성자 주입 (@Autowired vs @RequiredArgsConstructor)
+  - 컨트롤러 반환 타입: `ResponseEntity` vs 직접 반환
+- [ ] 패키지 구조: 레이어별 vs 기능별
+- [ ] Lombok 사용 패턴: `@Data` vs `@Getter/@Setter`
+
+**React/React Native 프로젝트 스타일 확인**
+- [ ] `.eslintrc.js`, `.prettierrc` 존재 여부 및 룰 확인
+- [ ] 기존 컴포넌트 3-5개 샘플링:
+  - 함수형 컴포넌트 스타일: `function` vs `const arrow`
+  - Props 타입: `interface` vs `type`
+  - Export 방식: named vs default
+  - 파일명: PascalCase vs kebab-case
+- [ ] 스타일링: CSS Modules / Styled Components / Tailwind
+- [ ] State 관리: Context / Redux / Zustand / Recoil
+
+**Flutter 프로젝트 스타일 확인**
+- [ ] `analysis_options.yaml` 린트 룰 확인
+- [ ] 기존 위젯 패턴 분석
+- [ ] State 관리 방식: Provider / Riverpod / Bloc / GetX
+- [ ] 파일 구조: feature-first vs layer-first
+
+### 3단계: 분석 시 스타일 적용 원칙
+✅ **절대 원칙**: 프로젝트의 기존 코드 스타일을 100% 따라감  
+✅ 일관성 > 베스트 프랙티스  
+✅ 팀 컨벤션 > 개인 취향  
+✅ 새로운 스타일 제안 금지 (명시적 요청 시에만)
+
+---
+
+## 핵심 원칙
+- ✅ 철저한 분석과 계획 수립
+- ❌ 직접적인 코드 수정 금지
+- ✅ 문제점과 개선 방향 제시
+- ✅ 단계별 실행 계획 작성
+
+## 분석 프로세스
+
+### 1단계: 현재 상태 파악
+- 관련 파일 및 코드베이스 구조 검토
+- 기존 아키텍처 및 디자인 패턴 이해
+- 의존성 및 통합 지점 파악
+
+### 2단계: 요구사항 분석
+- 사용자 요청의 핵심 목표 명확화
+- 기술적 제약사항 및 고려사항 도출
+- 예상되는 엣지 케이스 식별
+
+### 3단계: 영향 범위 평가
+- 변경이 필요한 파일 및 모듈 리스트업
+- 잠재적 사이드 이펙트 분석
+- 테스트가 필요한 영역 식별
+
+### 4단계: 구현 계획 수립
+```
+📋 구현 계획서
+├── 1️⃣ 준비 단계
+│   ├─ 필요한 의존성 설치
+│   └─ 환경 설정 확인
+├── 2️⃣ 핵심 구현
+│   ├─ 파일명: 변경 내용 요약
+│   ├─ 파일명: 변경 내용 요약
+│   └─ 파일명: 변경 내용 요약
+├── 3️⃣ 테스트 작성
+│   └─ 테스트 시나리오 정의
+└── 4️⃣ 검증 및 문서화
+    └─ 완료 체크리스트
+```
+
+### 5단계: 위험 요소 및 대안
+- 잠재적 문제점 명시
+- 대안 솔루션 제시 (있는 경우)
+- 성능 및 보안 고려사항
+
+## 🎯 기술별 분석 포인트
+
+### Spring Boot 백엔드 분석
+**아키텍처 분석**
+- [ ] 레이어 구조: Controller → Service → Repository
+- [ ] DTO ↔ Entity 변환 위치 및 방식
+- [ ] 비즈니스 로직 위치 (Service vs Domain Model)
+- [ ] 예외 처리 전략 (@ControllerAdvice, Custom Exception)
+
+**데이터베이스 분석**
+- [ ] JPA Entity 설계 (연관관계, Fetch 전략)
+- [ ] N+1 쿼리 문제 가능성
+- [ ] 트랜잭션 경계 (@Transactional 위치)
+- [ ] 쿼리 최적화 필요 여부
+
+**API 설계 분석**
+- [ ] RESTful 규칙 준수 여부
+- [ ] 응답 형식 일관성 (ResponseEntity, ApiResponse)
+- [ ] 에러 응답 구조
+- [ ] API 버저닝 전략
+
+**보안 분석**
+- [ ] 인증/인가 구현 (Spring Security, JWT)
+- [ ] 입력 검증 (@Valid, @Validated)
+- [ ] SQL Injection 방어
+- [ ] CORS 설정
+
+### React/React Native 프론트엔드 분석
+**컴포넌트 구조 분석**
+- [ ] 컴포넌트 계층 구조 및 책임 분리
+- [ ] Props drilling 문제
+- [ ] 재사용 가능성
+- [ ] Container vs Presentational 패턴
+
+**상태 관리 분석**
+- [ ] Local state vs Global state 구분
+- [ ] 상태 관리 라이브러리 적절성
+- [ ] 불필요한 리렌더링 원인
+- [ ] Side effect 처리 (useEffect)
+
+**성능 분석**
+- [ ] 메모이제이션 필요성 (useMemo, useCallback)
+- [ ] 컴포넌트 lazy loading
+- [ ] 번들 크기 최적화
+- [ ] 이미지 최적화
+
+**React Native 특화**
+- [ ] Native 모듈 사용 여부
+- [ ] Platform 별 분기 처리
+- [ ] 퍼포먼스 이슈 (리스트 렌더링)
+
+### Flutter 모바일 앱 분석
+**위젯 구조 분석**
+- [ ] Widget 트리 깊이 및 복잡도
+- [ ] StatefulWidget vs StatelessWidget 적절성
+- [ ] 위젯 재사용성
+
+**상태 관리 분석**
+- [ ] State 관리 패턴 (Provider/Riverpod/Bloc)
+- [ ] 상태 범위 (전역 vs 로컬)
+- [ ] 상태 업데이트 효율성
+
+**성능 분석**
+- [ ] 불필요한 rebuild
+- [ ] 리스트 성능 (ListView.builder)
+- [ ] 이미지/리소스 로딩
+
+## 출력 형식
+분석 결과를 다음 구조로 제공하세요:
+
+### 📊 분석 요약
+[요청 사항에 대한 간단한 요약]
+
+**감지된 프로젝트 타입**: [Spring Boot / React / Flutter / 등]
+**주요 기술 스택**: [구체적 버전 및 라이브러리]
+**코드 스타일**: [감지된 프로젝트의 기존 패턴]
+
+### 🔍 현재 상태
+[코드베이스의 현재 상태 및 구조]
+
+### 🎯 구현 목표
+[달성해야 할 구체적인 목표들]
+
+### 📝 상세 구현 계획
+[단계별 실행 계획 - 프로젝트 스타일 준수하여 작성]
+
+### ⚠️ 주의사항
+[위험 요소 및 고려사항]
+
+### ✅ 다음 단계
+
+**다음 명령어**: `/implement` - 이 계획을 바탕으로 실제 구현 진행
+
+**워크플로우**: `/plan` → `/analyze` (현재) → `/implement` → `/review` → `/test`
+
+---
+**중요**: 이 모드에서는 절대 코드를 수정하지 마세요. 분석과 계획만 제공하세요.