CLAUDE.md 템플릿

# Project: [프로젝트명]

## Overview
React/Next.js 기반 웹 애플리케이션

## Tech Stack
- Framework: Next.js 14
- Language: TypeScript (strict mode)
- Styling: Tailwind CSS
- State: Zustand / React Query

## Project Structure
```
src/
├── app/           # Next.js App Router
├── components/
│   ├── ui/        # 공통 UI 컴포넌트
│   └── features/  # 기능별 컴포넌트
├── hooks/         # 커스텀 훅
├── lib/           # 유틸리티
├── types/         # TypeScript 타입
└── styles/        # 글로벌 스타일
```

## Code Style Rules
- [ ] 컴포넌트는 함수형으로 작성
- [ ] Props는 interface로 정의
- [ ] 커스텀 훅은 use 접두사 사용
- [ ] 상태 관리는 최소화

## Naming Conventions
- 컴포넌트: PascalCase (Button.tsx)
- 훅: camelCase with use prefix (useAuth.ts)
- 유틸: camelCase (formatDate.ts)
- 타입: PascalCase with I prefix (IUser.ts)

## Commands
- `npm run dev` - 개발 서버 (localhost:3000)
- `npm run build` - 프로덕션 빌드
- `npm run lint` - ESLint 검사
- `npm run test` - Jest 테스트

## Important Notes
- 이미지는 next/image 사용
- API 호출은 lib/api.ts에서 관리
- 환경변수는 .env.local 사용

# Project: [프로젝트명]

## Overview
Node.js Express API 서버

## Tech Stack
- Runtime: Node.js 20
- Framework: Express.js
- Database: PostgreSQL + Prisma
- Auth: JWT

## Project Structure
```
src/
├── routes/        # API 라우트
├── controllers/   # 컨트롤러
├── services/      # 비즈니스 로직
├── models/        # 데이터 모델
├── middlewares/   # 미들웨어
├── utils/         # 유틸리티
└── config/        # 설정
```

## API Conventions
- RESTful 설계 원칙 준수
- 응답: { success: boolean, data: any, error?: string }
- 에러 코드: HTTP 표준 사용

## Code Style Rules
- [ ] async/await 사용 (콜백 금지)
- [ ] try-catch로 에러 핸들링
- [ ] 환경변수는 config에서 관리
- [ ] SQL 인젝션 방지 (파라미터 바인딩)

## Commands
- `npm run dev` - 개발 서버 (nodemon)
- `npm run start` - 프로덕션 서버
- `npm run migrate` - DB 마이그레이션
- `npm run seed` - 시드 데이터

## Important Notes
- .env 파일 절대 커밋 금지
- 민감한 정보는 환경변수로
- 로깅은 winston 사용

# Project: [프로젝트명]

## Overview
FastAPI 기반 Python API 서버

## Tech Stack
- Language: Python 3.11
- Framework: FastAPI
- Database: PostgreSQL + SQLAlchemy
- Task Queue: Celery + Redis

## Project Structure
```
app/
├── api/
│   └── v1/        # API 버전별 라우트
├── core/          # 설정, 보안
├── models/        # SQLAlchemy 모델
├── schemas/       # Pydantic 스키마
├── services/      # 비즈니스 로직
└── utils/         # 유틸리티
```

## Code Style Rules
- [ ] Type hints 필수
- [ ] Docstring 작성 (Google style)
- [ ] Black으로 포맷팅
- [ ] pytest로 테스트

## Commands
- `uvicorn app.main:app --reload` - 개발 서버
- `pytest` - 테스트 실행
- `black .` - 코드 포맷팅
- `alembic upgrade head` - DB 마이그레이션

## Important Notes
- 가상환경 사용 필수 (venv)
- requirements.txt 최신 유지
- 비동기 함수는 async def 사용