# 프로젝트 가이드

## 기술 스택

- Next.js 14 (App Router)
- TypeScript (strict mode)
- Tailwind CSS
- Prisma ORM

## 명령어

- `npm run dev` - 개발 서버 시작
- `npm run test` - 테스트 실행
- `npm run lint` - 코드 검사

## 규칙

- 모든 컴포넌트는 함수형으로 작성하며, class를 사용하지 않음
- API 라우트는 `app/api/`에 배치
- 데이터베이스 작업은 모두 `lib/db.ts`를 통해 처리
- 오류 처리는 `lib/errors.ts`의 유틸리티 함수 사용

## 파일 구조

app/ - Next.js 페이지 및 라우트
components/ - 재사용 가능한 컴포넌트
lib/ - 유틸리티 함수 및 설정
prisma/ - 데이터베이스 스키마

# 내 개인 선호도

- 테스트는 Jest 대신 Vitest 사용
- 컴포넌트 파일에는 항상 PropTypes 포함
- 커밋 메시지는 한국어로 작성

.claude/rules/
  ├── api-conventions.md
  ├── testing.md
  ├── security.md
  └── ui-patterns.md

---
paths:
  - "src/api/**"
---

---
paths:
  - "src/api/**"
  - "src/handlers/**"
---

# API 개발 규칙

모든 API 엔드포인트는 반드시:
- 통일된 JSON 형식 반환
- 오류 처리 포함
- 요청 로그 기록

# 코드 리뷰

최근 코드 변경 사항 리뷰:

!`git diff main...HEAD`

중점 확인 사항:
- 코드 스타일 일관성
- 잠재적 성능 문제
- 보안 취약점
- 테스트 커버리지

# 문제 수정

문제 세부 정보를 가져와 수정方案 제공:

!`gh issue view $ARGUMENTS`

이 문제를 분석하고 수정 단계를 제안합니다.

.claude/skills/
  └── security-review/
      ├── SKILL.md
      └── DETAILED_GUIDE.md

---
name: security-review
description: 코드에 대한 보안 검토를 수행하고 일반적인 취약점을 확인합니다
---

# 보안 검토

\@DETAILED_GUIDE.md의 기준에 따라 코드 검토:

1. SQL 인젝션 위험 확인
2. 입력 검증 확인
3. 민감 데이터 노출 확인
4. 권한 제어 검토

.claude/agents/
  ├── code-reviewer.md
  ├── security-auditor.md
  └── performance-analyzer.md

---
name: code-reviewer
description: 코드 품질, 스타일 및 모범 사례 검토
tools: [Read, Grep, Glob]
model: claude-3-5-haiku-20241022
---

당신은 코드 리뷰 전문가입니다. 코드를 검토할 때 다음 사항에 중점을 둡니다:

1. 코드 스타일 일관성
2. 잠재적 버그 및 경계 조건
3. 성능 문제
4. 유지보수성

구체적인 개선 제안을 제공하고, 특정 코드 줄을 인용하세요.

{
  "$schema": "https://cdn.gooo.ai/schemas/claude-settings.json",
  "allow": [
    "Bash(npm run *)",
    "Bash(make *)",
    "Bash(git *)",
    "Read",
    "Write",
    "Edit",
    "Glob",
    "Grep"
  ],
  "deny": [
    "Bash(rm -rf *)",
    "Bash(curl *)",
    "Read(.env)",
    "Read(secrets/**)"
  ]
}

项目级别 (.claude/)
├── CLAUDE.md              # 团队指令(必须)
├── CLAUDE.local.md        # 你的个人覆盖(gitignored)
├── settings.json          # 团队权限
├── settings.local.json    # 你的权限覆盖(gitignored)
├── rules/                 # 模块化指令
│   ├── api-conventions.md
│   ├── testing.md
│   └── security.md
├── commands/              # 团队自定义命令
│   ├── review.md
│   └── fix-issue.md
├── skills/                # 团队可复用工作流
│   └── security-review/
│       ├── SKILL.md
│       └── DETAILED_GUIDE.md
└── agents/                # 团队专业子 agents
    ├── code-reviewer.md
    └── security-auditor.md

全局级别 (~/.claude/)
├── CLAUDE.md              # 你的全局偏好
├── projects/              # 每个项目的会话和记忆
│   └── your-project/
│       ├── transcripts/
│       └── memory.md
├── commands/              # 你的个人命令
├── skills/                # 你的个人 skills
└── agents/                # 你的个人 agents