jun-claude-code 0.0.1

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

@@ -0,0 +1,184 @@
+---
+name: Coding
+description: 모든 코드 작성 시 참조. SRP/결합도/응집도 판단 기준, 폴더 구조 설계 원칙, 삼항연산자/try-catch 가독성 규칙 제공.
+keywords: [SRP, 단일책임, 결합도, 응집도, 설계원칙, 폴더구조, 아키텍처, 가독성, 삼항연산자, try-catch]
+estimated_tokens: ~500
+---
+
+# 공통 코딩 원칙
+
+## 단일 책임 원칙 (SRP)
+
+> **하나의 모듈/컴포넌트는 하나의 책임만 가진다.**
+
+### 백엔드 레이어별 책임
+
+| 레이어 | 책임 | 금지 |
+|--------|------|------|
+| **Entity** | 데이터 구조 정의 | 비즈니스 로직 |
+| **Repository** | 데이터 접근 | 비즈니스 로직 |
+| **Service** | 비즈니스 로직 | HTTP 의존 |
+| **Controller** | 요청 라우팅 | 비즈니스 로직 |
+| **DTO/Schema** | 데이터 전송 구조 | 로직 |
+
+### 프론트엔드 컴포넌트별 책임
+
+| 유형 | 책임 | 금지 |
+|------|------|------|
+| **Page** | 레이아웃, 데이터 fetch | 복잡한 로직 |
+| **Container** | 상태 관리, API 호출 | 과도한 UI |
+| **Presentational** | UI 렌더링 | API 호출, 전역 상태 |
+| **Hook** | 특정 로직 캡슐화 | 여러 책임 혼합 |
+| **Store** | 전역 상태 | UI 로직 |
+
+---
+
+## 결합도 낮추기
+
+> **모듈 간 의존성을 최소화한다.**
+
+### 공통 규칙
+
+| 규칙 | 설명 |
+|------|------|
+| **순환 의존 금지** | A → B → A 형태 금지 |
+| **상위 모듈 의존 금지** | shared는 도메인 모듈 의존 금지 |
+| **인터페이스로 의존** | 구체 클래스 대신 추상화에 의존 |
+| **공개 API 통해 접근** | index.ts를 통한 export만 사용 |
+
+### 백엔드
+
+```typescript
+// 토큰 기반 주입 / 인터페이스 의존
+@Inject(PRODUCT_REPOSITORY)
+private readonly repository: IProductRepository
+
+// 구체 클래스 직접 의존 금지
+private readonly repository: ProductRepository
+```
+
+### 프론트엔드
+
+```typescript
+// props로 의존성 전달
+function ProductCard({ product, onAction }: Props) { ... }
+
+// 전역 상태 직접 접근 (Presentational에서) 금지
+const action = useStore(s => s.action);
+```
+
+---
+
+## 응집도 높이기
+
+> **관련 있는 코드는 가까이 둔다.**
+
+### 폴더 구조 원칙
+
+```
+높은 응집도:
+- 같은 도메인 파일은 같은 폴더에
+- 컴포넌트와 관련 스타일은 같은 파일에
+- 기능별 hook 분리
+
+낮은 응집도 (피해야 함):
+- 관련 없는 기능을 한 파일에
+- 모든 컴포넌트를 최상위에
+- 여러 도메인을 한 모듈에서 처리
+```
+
+### 폴더 구조 예시
+
+```
+src/
+├── module/
+│   ├── domain/          # Entity (공유)
+│   ├── product/         # 기능별 폴더
+│   │   ├── product.controller.ts
+│   │   ├── product.service.ts
+│   │   ├── product.dto.ts
+│   │   └── product.module.ts
+│   └── order/
+└── shared/              # 공통 (상위 의존 금지)
+```
+
+```
+src/
+├── components/
+│   ├── product/         # 도메인별 폴더
+│   │   ├── ProductCard.tsx
+│   │   ├── ProductList.tsx
+│   │   └── index.ts
+│   └── common/          # 공통 (도메인 의존 금지)
+├── hooks/               # 도메인별 hook
+├── store/               # 전역 상태
+└── shared/              # 유틸리티
+```
+
+---
+
+## 가독성 규칙
+
+### try-catch vs then-catch
+
+> **Promise 처리 시 `then-catch` 패턴을 사용한다.**
+
+```typescript
+// ❌ try-catch (가독성 저하)
+async function fetchUser(id: string) {
+  try {
+    const user = await userService.findById(id);
+    return user;
+  } catch (error) {
+    throw new NotFoundException('User not found');
+  }
+}
+
+// ✅ then-catch (가독성 향상)
+function fetchUser(id: string) {
+  return userService.findById(id)
+    .then(user => user)
+    .catch(() => {
+      throw new NotFoundException('User not found');
+    });
+}
+```
+
+### 삼항연산자 규칙
+
+> **삼항연산자에서 인자가 2개 이상인 함수를 호출하지 않는다.**
+
+```typescript
+// ❌ 삼항연산자 내 복잡한 함수 호출
+const result = isAdmin
+  ? processAdminData(data, options, config)
+  : processUserData(data, options);
+
+// ✅ 변수로 분리 후 사용
+const processor = isAdmin ? processAdminData : processUserData;
+const result = processor(data, options, config);
+
+// ✅ 또는 if문 사용
+let result;
+if (isAdmin) {
+  result = processAdminData(data, options, config);
+} else {
+  result = processUserData(data, options);
+}
+```
+
+**삼항연산자 허용 케이스:**
+- 단순 값 선택: `const name = isKorean ? '홍길동' : 'John';`
+- 인자 없는/1개 함수: `const value = isValid ? getValue() : getDefault();`
+
+---
+
+## 코드 작성 시 체크리스트
+
+- [ ] 이 파일의 책임은 하나인가?
+- [ ] 다른 모듈에 불필요하게 의존하고 있지 않은가?
+- [ ] 관련 파일들이 같은 폴더에 있는가?
+- [ ] 순환 의존이 발생하지 않는가?
+- [ ] 공개 API(index.ts)를 통해 접근하는가?
+- [ ] Promise 처리에 then-catch 패턴을 사용했는가?
+- [ ] 삼항연산자에서 복잡한 함수 호출을 피했는가?

package/.claude/skills/Documentation/SKILL.md

@@ -0,0 +1,290 @@
+---
+name: Documentation
+description: .claude 폴더 내 문서 생성/수정 시 사용. frontmatter 형식, Context/Skill/Agent 템플릿, 파일 분리 기준 제공.
+keywords: [문서, 작성, CLAUDE.md, context, skill, agent, frontmatter, 템플릿]
+estimated_tokens: ~800
+---
+
+# .claude 문서 작성 스킬
+
+## 핵심 원칙
+
+1. **Context 압축**: 토큰 절약을 위해 최대한 압축
+2. **검색 가능성**: keywords로 정확한 매칭
+3. **독립성**: 각 파일이 단독으로 이해 가능
+4. **참조 명시**: 관련 문서 경로 항상 포함
+
+## 디렉토리 구조
+
+```
+.claude/
+├── CLAUDE.md          # 프로젝트 전체 가이드 (인덱스 역할)
+├── context/           # 사실/배경 정보 (읽기 전용)
+│   ├── architecture.md
+│   └── domain/
+├── skills/            # 방법/절차 가이드 (액션 지침)
+│   ├── Coding/
+│   │   └── SKILL.md
+│   └── React/
+│       ├── SKILL.md   # 인덱스
+│       └── sub-skill.md
+├── agents/            # Agent 정의
+│   └── explore.md
+└── hooks/             # 자동 실행 스크립트
+    └── pre-commit.sh
+```
+
+## 파일 유형 구분
+
+| 유형 | 목적 | 위치 | 예시 |
+|------|------|------|------|
+| Context | 사실/배경 ("우리 프로젝트는 이렇다") | `context/` | 아키텍처, 도메인 지식 |
+| Skill | 방법/절차 ("이렇게 해라") | `skills/` | 코딩 규칙, Git 규칙 |
+| Agent | 역할/프로세스 ("이 Agent가 한다") | `agents/` | explore, code-writer |
+| Hook | 자동 실행 ("이 시점에 실행") | `hooks/` | pre-commit, post-push |
+
+## Frontmatter 필수 작성
+
+모든 `.md` 파일은 YAML frontmatter로 시작합니다.
+
+### 공통 필드
+
+```yaml
+---
+name: file-name              # 파일 식별자 (kebab-case)
+description: 한 줄 설명       # 파일 목적 (50자 이내)
+keywords: [키워드1, 키워드2]  # 검색/매칭용 (한글, 영문 혼용)
+estimated_tokens: ~500       # 예상 토큰 수
+---
+```
+
+### Agent 전용 필드
+
+```yaml
+---
+name: agent-name
+description: Agent 역할 설명
+keywords: [...]
+model: opus                  # opus | sonnet | haiku
+color: blue                  # UI 표시 색상
+---
+```
+
+### Skill 전용 필드
+
+```yaml
+---
+name: skill-name
+description: Skill 목적
+keywords: [...]
+user-invocable: true         # 사용자가 /skill-name으로 호출 가능
+---
+```
+
+## 파일 길이 제한
+
+| 상태 | 줄 수 | 조치 |
+|------|-------|------|
+| 권장 | ~500줄 | 이상적인 길이 |
+| 허용 | ~1000줄 | 최대 한계 |
+| 초과 | 1000줄+ | 반드시 파일 분리 |
+
+**초과 시 분리 방법:**
+- Skill: `SKILL.md` (인덱스) + `sub-skill.md` (상세)
+- Context: `INDEX.md` (요약) + `detail.md` (상세)
+
+## 파일 유형별 템플릿
+
+### Context 템플릿
+
+```markdown
+---
+name: context-name
+description: 설명
+keywords: [키워드1, 키워드2]
+estimated_tokens: ~300
+---
+
+# 제목
+
+## 핵심 정보
+
+(테이블, 다이어그램으로 핵심만 요약)
+
+| 항목 | 값 |
+|------|-----|
+| ... | ... |
+
+## 상세 구조
+
+(필요시 코드 블록, 상세 설명)
+
+## 관련 파일
+
+- `path/to/related.md` - 설명
+- `src/module/` - 관련 소스 코드
+```
+
+### Skill 템플릿
+
+```markdown
+---
+name: skill-name
+description: 설명
+keywords: [키워드1, 키워드2]
+estimated_tokens: ~400
+---
+
+# 스킬 제목
+
+## 핵심 역할
+
+- 역할 1
+- 역할 2
+
+## 필수 준수 사항
+
+| 규칙 | 올바른 예 | 잘못된 예 |
+|------|----------|----------|
+| ... | ... | ... |
+
+## 코드 예제
+
+\`\`\`typescript
+// 올바른 패턴
+\`\`\`
+
+## 체크리스트
+
+- [ ] 확인 항목 1
+- [ ] 확인 항목 2
+
+## 관련 문서
+
+| 문서 | 설명 |
+|------|------|
+| `sub-skill.md` | 상세 내용 |
+```
+
+### Agent 템플릿
+
+```markdown
+---
+name: agent-name
+description: Agent 역할 설명
+keywords: [키워드1, 키워드2]
+model: sonnet
+color: blue
+---
+
+# Agent 이름
+
+## 역할
+
+1. 첫 번째 역할
+2. 두 번째 역할
+
+## 언제 사용하는가
+
+- 사용 시점 1
+- 사용 시점 2
+
+## 프로세스
+
+### Step 1: 준비
+...
+
+### Step 2: 실행
+...
+
+## 출력 형식
+
+\`\`\`markdown
+# 결과 제목
+
+## 요약
+...
+\`\`\`
+```
+
+## 인덱스 파일 작성법
+
+Skill이 여러 파일로 분리되면 `SKILL.md`가 인덱스 역할을 합니다.
+
+```markdown
+---
+name: skill-name
+description: 스킬 그룹 설명
+keywords: [...]
+---
+
+# 스킬 제목
+
+## 핵심 역할
+
+(간단한 요약)
+
+## 관련 문서
+
+| 문서 | 설명 |
+|------|------|
+| `sub-skill-1.md` | 세부 주제 1 |
+| `sub-skill-2.md` | 세부 주제 2 |
+
+(인덱스 파일에서는 상세 내용 작성하지 않음)
+```
+
+## Keywords 작성 가이드
+
+효과적인 검색을 위해 다양한 변형을 포함합니다.
+
+```yaml
+keywords:
+  - React           # 영문 정식 명칭
+  - 리액트           # 한글
+  - component       # 관련 개념 (영문)
+  - 컴포넌트         # 관련 개념 (한글)
+  - hooks           # 세부 기능
+  - useState        # 구체적 API
+```
+
+**포함할 것:**
+- 정식 명칭 (영문/한글)
+- 약어 (예: RHF for React Hook Form)
+- 관련 개념
+- 자주 검색하는 키워드
+
+## 작성 시 주의사항
+
+### DO (해야 할 것)
+
+- 테이블로 정보 압축
+- 코드 예제에 주석 최소화
+- 한 파일에 하나의 주제
+- 관련 문서 참조 명시
+- 체크리스트로 검증 포인트 제공
+
+### DON'T (하지 말 것)
+
+- 장황한 설명 (압축!)
+- 중복된 내용 (참조로 대체)
+- 1000줄 초과 (분리!)
+- frontmatter 누락
+- 모호한 keywords
+
+## 체크리스트
+
+### 새 파일 작성 시
+- [ ] frontmatter가 올바르게 작성되었는가?
+- [ ] keywords에 영문/한글 변형이 포함되었는가?
+- [ ] 500줄 이하인가? (초과 시 분리 검토)
+- [ ] 관련 문서 참조가 명시되었는가?
+
+### 인덱스 파일인 경우
+- [ ] 관련 문서 테이블이 있는가?
+- [ ] 상세 내용은 sub-file로 분리되었는가?
+
+### Agent 파일인 경우
+- [ ] model 필드가 지정되었는가?
+- [ ] 프로세스가 Step별로 명시되었는가?
+- [ ] 출력 형식이 정의되었는가?

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

@@ -0,0 +1,45 @@
+---
+name: Git
+description: 커밋/PR/브랜치 작업 시 사용. FEAT/FIX/REFACTOR 메시지 규칙, PR 템플릿, 리뷰 체크리스트 인덱스 제공.
+keywords: [커밋, PR, 브랜치, push, merge, FEAT, FIX, 코드리뷰, PR리뷰, 피드백]
+estimated_tokens: ~100
+---
+
+# Git 작업 스킬
+
+## 이 스킬이 필요할 때
+
+- Git commit 메시지 작성
+- Pull Request 생성
+- PR/MR 코드 리뷰
+- 리뷰 피드백 반영
+
+## 관련 문서
+
+| 주제 | 위치 | 설명 |
+|-----|------|------|
+| Commit/PR 생성 | `git.md` | 메시지 형식, PR 작성법, 브랜치 전략, 안전 규칙 |
+| PR 리뷰 | `pr-review.md` | 체크리스트 기반 코드 리뷰 워크플로우 |
+| PR 피드백 적용 | `pr-apply.md` | 리뷰 피드백 분류 및 반영 방법 |
+
+## 빠른 참조
+
+### Commit PREFIX
+
+| PREFIX | 용도 |
+|--------|------|
+| FEAT | 새로운 기능 |
+| FIX | 버그 수정 |
+| REFACTOR | 리팩토링 |
+| CHORE | 빌드/설정 |
+| DOCS | 문서 |
+
+> 상세 형식 및 예시: `git.md`
+
+### PR 워크플로우
+
+```
+변경사항 분석 → 영향 분석 → PR 작성 → Self Review → 팀원 리뷰 → Merge
+```
+
+> 상세 Step: `git.md`