# 프로젝트: Acme API

## 명령어

npm run dev          # 개발 서버 시작
npm run test         # 테스트 실행 (Jest)
npm run lint         # ESLint + Prettier 검사
npm run build        # 프로덕션 빌드

## 아키텍처

- Express REST API, Node 20
- Prisma ORM을 통한 PostgreSQL
- 모든 핸들러는 src/handlers/에 위치
- 공유 타입은 src/types/에 위치

## 규칙

- 모든 핸들러에서 요청 검증에 zod 사용
- 반환 형태는 항상 { data, error }
- 클라이언트에 스택 트레이스를 절대 노출하지 않음
- console.log 대신 logger 모듈 사용

## 주의사항

- 테스트는 모의 객체가 아닌 실제 로컬 DB를 사용합니다. 먼저 `npm run db:test:reset` 실행
- 엄격한 TypeScript: 사용하지 않는 임포트는 절대 허용되지 않음

.claude/rules/
├── code-style.md
├── testing.md
├── api-conventions.md
└── security.md

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

# API 디자인 규칙

- 모든 핸들러는 { data, error } 형태 반환
- 요청 본문 검증에 zod 사용
- 내부 오류 세부 정보를 클라이언트에 절대 노출하지 않음

## description: 병합 전 현재 브랜치의 차이점을 검토하여 문제를 찾습니다

## 검토할 변경 사항

!`git diff --name-only main...HEAD`

## 상세 차이점

!`git diff main...HEAD`

위 변경 사항을 다음 항목에 대해 검토하세요:
1. 코드 품질 문제
2. 보안 취약점
3. 누락된 테스트 커버리지
4. 성능 문제

파일별로 구체적이고 실행 가능한 피드백을 제공하세요.

---
description: GitHub 이슈를 조사하고 수정합니다
argument-hint: [이슈-번호]
---
이 저장소에서 #$ARGUMENTS 이슈를 확인하세요.

!`gh issue view $ARGUMENTS`

버그를 이해하고, 근본 원인을 추적하고, 수정하고, 이를 발견했을 테스트를 작성하세요.

.claude/skills/
├── security-review/
│   ├── SKILL.md
│   └── DETAILED_GUIDE.md
└── deploy/
    ├── SKILL.md
    └── templates/
        └── release-notes.md

---
name: security-review
description: 포괄적인 보안 감사. 코드의 취약점을 검토할 때, 배포 전,
  또는 사용자가 보안을 언급할 때 사용합니다.
allowed-tools: Read, Grep, Glob
---
코드베이스의 보안 취약점을 분석합니다:

1. SQL 인젝션 및 XSS 위험
2. 노출된 자격 증명 또는 비밀
3. 안전하지 않은 설정
4. 인증 및 권한 부여 격차

심각도 등급과 구체적인 수정 단계를 포함한 결과를 보고합니다.
보안 표준은 @DETAILED_GUIDE.md를 참조하세요.

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

---
name: code-reviewer
description: 전문 코드 리뷰어. PR을 검토하거나, 버그를 확인하거나,
  병합 전 구현을 검증할 때 적극적으로 사용합니다.
model: sonnet
tools: Read, Grep, Glob
---
당신은 정확성과 유지보수성에 중점을 둔 시니어 코드 리뷰어입니다.

코드를 검토할 때:
- 스타일 문제뿐만 아니라 버그도 지적하세요
- 모호한 개선 사항 대신 구체적인 수정을 제안하세요
- 엣지 케이스와 오류 처리 누락을 확인하세요
- 대규모 환경에서만 중요한 성능 문제에 주목하세요

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Read",
      "Write",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

your-project/
├── CLAUDE.md                  # 팀 지침 (커밋됨)
├── CLAUDE.local.md            # 개인 재정의 (gitignore 처리됨)
│
└── .claude/
    ├── settings.json          # 권한 + 설정 (커밋됨)
    ├── settings.local.json    # 개인 권한 재정의 (gitignore 처리됨)
    │
    ├── commands/              # 사용자 정의 슬래시 명령어
    │   ├── review.md          # → /project:review
    │   ├── fix-issue.md       # → /project:fix-issue
    │   └── deploy.md          # → /project:deploy
    │
    ├── rules/                 # 모듈식 지침 파일
    │   ├── code-style.md
    │   ├── testing.md
    │   └── api-conventions.md
    │
    ├── skills/                # 자동 호출 워크플로우
    │   ├── security-review/
    │   │   └── SKILL.md
    │   └── deploy/
    │       └── SKILL.md
    │
    └── agents/                # 특화된 하위 에이전트 페르소나
        ├── code-reviewer.md
        └── security-auditor.md

~/.claude/
├── CLAUDE.md                  # 전역 지침
├── settings.json              # 전역 설정
├── commands/                  # 개인 명령어 (모든 프로젝트)
├── skills/                    # 개인 스킬 (모든 프로젝트)
├── agents/                    # 개인 에이전트 (모든 프로젝트)
└── projects/                  # 세션 기록 + 자동 메모리