@choblue/claude-code-toolkit 1.0.0

package/.claude/skills/Coding/SKILL.md

@@ -0,0 +1,108 @@
+# Coding Skill - 공통 원칙
+
+이 문서는 모든 코드 작성 시 적용되는 공통 원칙을 정의한다.
+FE/BE별 상세 규칙은 각각의 파일을 참고한다.
+- `frontend.md` - React 프론트엔드 규칙
+- `backend.md` - NestJS 백엔드 규칙
+
+---
+
+## 1. 설계 원칙
+
+### SRP (Single Responsibility Principle)
+- 함수는 하나의 작업만 수행한다
+- 클래스/모듈은 하나의 책임만 갖는다
+- "이 함수가 하는 일"을 한 문장으로 설명할 수 없으면 분리한다
+
+### 결합도(Coupling)와 응집도(Cohesion)
+- **낮은 결합도**: 모듈 간 의존성을 최소화한다
+  - 인터페이스/추상화를 통해 의존한다
+  - 구현 세부사항에 직접 의존하지 않는다
+- **높은 응집도**: 관련 있는 로직을 같은 모듈에 모은다
+  - 하나의 모듈 안에서 데이터와 동작이 밀접하게 관련된다
+
+### DRY (Don't Repeat Yourself)
+- 동일한 로직이 3번 이상 반복되면 추출한다
+- 단, 2번까지는 중복을 허용한다 (섣부른 추상화 방지)
+
+---
+
+## 2. 네이밍 컨벤션
+
+### 일반 규칙
+- 의도를 드러내는 이름을 사용한다
+- 축약어를 피한다 (`btn` → `button`, `msg` → `message`)
+- 단, 관례적 축약은 허용한다 (`id`, `url`, `api`, `dto`)
+
+### 변수/함수
+```
+// Bad
+const d = new Date();
+const list = getItems();
+function process(data) {}
+
+// Good
+const createdAt = new Date();
+const activeUsers = getActiveUsers();
+function validateUserInput(input) {}
+```
+
+### Boolean
+- `is`, `has`, `can`, `should` 접두사를 사용한다
+```
+isActive, hasPermission, canEdit, shouldRender
+```
+
+### 함수
+- 동사로 시작한다
+- 반환값이 예측 가능한 이름을 사용한다
+```
+getUserById()    // User 반환
+calculateTotal() // number 반환
+isValid()        // boolean 반환
+```
+
+---
+
+## 3. 에러 핸들링
+
+### 원칙
+- 시스템 경계(외부 API, 사용자 입력, 파일 I/O)에서 에러를 처리한다
+- 내부 로직에서 불필요한 try-catch를 남발하지 않는다
+- 에러 메시지는 디버깅에 도움되는 정보를 포함한다
+
+### 패턴
+```typescript
+// Bad - 에러를 삼킴
+try {
+  await saveUser(user);
+} catch (e) {
+  // do nothing
+}
+
+// Bad - 원본 에러 정보 손실
+try {
+  await saveUser(user);
+} catch (e) {
+  throw new Error('저장 실패');
+}
+
+// Good - 원본 에러 보존
+try {
+  await saveUser(user);
+} catch (e) {
+  throw new Error(`사용자 저장 실패: ${user.id}`, { cause: e });
+}
+```
+
+---
+
+## 4. 코드 품질 체크리스트
+
+코드 작성/리뷰 시 다음을 확인한다:
+- [ ] 함수/클래스가 SRP를 지키는가?
+- [ ] 네이밍이 의도를 드러내는가?
+- [ ] 시스템 경계에서 에러 핸들링이 되어 있는가?
+- [ ] 불필요한 복잡도가 없는가?
+- [ ] `any` 타입을 사용하지 않았는가?
+- [ ] 기존 프로젝트 패턴과 일관성이 있는가?

package/.claude/skills/Coding/backend.md

@@ -0,0 +1,97 @@
+# Coding Skill - Backend (NestJS)
+
+NestJS 백엔드 코드에 적용되는 규칙이다.
+공통 원칙은 `SKILL.md`를 함께 참고한다.
+
+---
+
+## 1. 레이어별 책임
+
+### Controller
+- HTTP 요청/응답 변환
+- DTO 유효성 검증 (데코레이터를 통해)
+- 비즈니스 로직 없음
+- 적절한 HTTP 데코레이터 사용 (`@Get`, `@Post`, `@Param`, `@Body` 등)
+
+### Service
+- 비즈니스 로직 처리
+- 트랜잭션 관리
+- 다른 Service 조합
+- 순환 참조 금지
+
+### Repository
+- 데이터베이스 CRUD
+- 쿼리 작성
+- 데이터 매핑
+
+### Guard / Interceptor / Pipe
+- 횡단 관심사 (인증, 로깅, 변환)
+- 재사용 가능하게 설계
+
+---
+
+## 2. DTO 작성
+
+- `class-validator` 데코레이터로 유효성 검증을 선언한다
+- `class-transformer`를 활용하여 변환한다
+- Partial, Pick, Omit 등 mapped type을 활용한다
+
+```typescript
+export class CreateUserDto {
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @IsEmail()
+  email: string;
+}
+
+export class UpdateUserDto extends PartialType(CreateUserDto) {}
+```
+
+---
+
+## 3. 에러 핸들링 (NestJS)
+
+- NestJS 내장 `HttpException`을 사용한다
+- 커스텀 예외는 `HttpException`을 상속한다
+- 글로벌 Exception Filter를 활용한다
+- Service에서 HttpException을 직접 던지지 않는다 (비즈니스 예외를 별도 정의)
+
+```typescript
+// Bad - Service에서 HTTP 의존
+throw new NotFoundException('사용자를 찾을 수 없습니다');
+
+// Good - 비즈니스 예외 정의 후 Controller/Filter에서 변환
+throw new UserNotFoundException(userId);
+```
+
+---
+
+## 4. 의존성 주입 (DI)
+
+- `new`로 직접 생성하지 않는다 - DI를 통해 주입받는다
+- 환경 변수는 `ConfigService`를 통해 접근한다
+- 인터페이스 기반 주입을 권장한다
+
+---
+
+## 5. 네이밍 컨벤션 (BE)
+
+| 대상 | 규칙 | 예시 |
+|------|------|------|
+| 파일 | `kebab-case` | `create-user.dto.ts` |
+| 클래스 | `PascalCase` + 역할 접미사 | `UserService`, `CreateUserDto` |
+| 메서드 | `camelCase` + 동사 | `findById`, `createUser` |
+| 테스트 | `*.spec.ts` | `user.service.spec.ts` |
+| 모듈 디렉토리 | `kebab-case` | `user-profile/` |
+
+---
+
+## 6. 금지 사항
+
+- Controller에 비즈니스 로직 작성 금지
+- Repository 외 레이어에서 직접 쿼리 실행 금지
+- `any` 타입 사용 금지
+- 환경 변수 직접 접근 (`process.env`) 금지 → `ConfigService` 사용
+- 순환 의존 금지 (Module 간, Service 간)

package/.claude/skills/Coding/frontend.md

@@ -0,0 +1,11 @@
+# Coding Skill - Frontend
+
+> **이 파일은 더 이상 사용되지 않는다.**
+> 프론트엔드 규칙은 기술별 스킬 파일로 분리되었다.
+
+- `../React/SKILL.md` - React 컴포넌트, 훅, 상태 관리
+- `../NextJS/SKILL.md` - Next.js App Router, SSR, Server Actions
+- `../TailwindCSS/SKILL.md` - Tailwind CSS 유틸리티 패턴
+- `../TanStackQuery/SKILL.md` - 서버 상태 관리 (React Query)
+- `../Zustand/SKILL.md` - 클라이언트 전역 상태 관리
+- `../ReactHookForm/SKILL.md` - 폼 관리 + Zod 검증

package/.claude/skills/Git/SKILL.md

@@ -0,0 +1,93 @@
+# Git Skill - Git 규칙
+
+커밋, PR, 브랜치 관련 규칙을 정의한다.
+
+---
+
+## 1. 커밋 메시지
+
+### 형식
+```
+<PREFIX>: <설명>
+
+<본문 (선택)>
+```
+
+### PREFIX
+| PREFIX | 용도 | 예시 |
+|--------|------|------|
+| `FEAT` | 새로운 기능 | `FEAT: 사용자 인증 기능 추가` |
+| `FIX` | 버그 수정 | `FIX: 로그인 리다이렉트 무한 루프 수정` |
+| `REFACTOR` | 리팩토링 (기능 변경 없음) | `REFACTOR: OrderService 쿼리 최적화` |
+| `CHORE` | 빌드, 설정, 의존성 | `CHORE: ESLint 설정 업데이트` |
+| `DOCS` | 문서 변경 | `DOCS: API 문서 업데이트` |
+| `TEST` | 테스트 추가/수정 | `TEST: UserService 단위 테스트 추가` |
+| `STYLE` | 포매팅 (코드 변경 없음) | `STYLE: import 정렬` |
+
+### 작성 원칙
+- 설명은 한국어로, 명령형으로 작성한다
+- 본문은 "왜" 변경했는지를 설명한다
+- 하나의 커밋은 하나의 논리적 변경만 포함한다
+
+---
+
+## 2. 브랜치 전략
+
+### 형식
+```
+<type>/<description>
+```
+
+### 타입
+| 타입 | 용도 |
+|------|------|
+| `feat/` | 기능 개발 |
+| `fix/` | 버그 수정 |
+| `refactor/` | 리팩토링 |
+| `chore/` | 설정/환경 |
+
+### 예시
+```
+feat/user-authentication
+fix/login-redirect-loop
+refactor/order-service-cleanup
+```
+
+---
+
+## 3. PR 템플릿
+
+### 제목
+- 70자 이내
+- PREFIX 포함 (e.g., "FEAT: 사용자 인증 기능 추가")
+
+### 본문
+```markdown
+## Summary
+- 변경 내용을 1-3개 bullet point로 요약
+
+## Changes
+- 주요 변경 사항 상세 설명
+
+## Test Plan
+- [ ] 테스트 항목 1
+- [ ] 테스트 항목 2
+```
+
+---
+
+## 4. 스테이징 규칙
+
+- **`git add -A` 또는 `git add .`는 절대 사용하지 않는다**
+- 변경된 파일을 하나씩 확인하고 관련 파일만 스테이징한다
+- `.env`, credentials, 대용량 바이너리는 스테이징하지 않는다
+
+---
+
+## 5. 금지 사항
+
+- `git push --force` (명시적 요청 없이)
+- `git reset --hard` (명시적 요청 없이)
+- `main`/`master` 브랜치에 직접 push
+- 커밋 시 `--no-verify` 사용
+- 빈 커밋 생성