jun-claude-code 0.0.11 → 0.0.13

package/{.claude → templates/global}/skills/Coding/SKILL.md

@@ -7,29 +7,31 @@ estimated_tokens: ~500
 
 # 공통 코딩 원칙
 
+<rules>
+
 ## 단일 책임 원칙 (SRP)
 
 > **하나의 모듈/컴포넌트는 하나의 책임만 가진다.**
 
 ### 백엔드 레이어별 책임
 
-| 레이어 | 책임 | 금지 |
-|--------|------|------|
-| **Entity** | 데이터 구조 정의 | 비즈니스 로직 |
-| **Repository** | 데이터 접근 | 비즈니스 로직 |
-| **Service** | 비즈니스 로직 | HTTP 의존 |
-| **Controller** | 요청 라우팅 | 비즈니스 로직 |
-| **DTO/Schema** | 데이터 전송 구조 | 로직 |
+| 레이어 | 책임 | 전담 영역 |
+|--------|------|----------|
+| **Entity** | 데이터 구조 정의 | 구조 정의에 집중 |
+| **Repository** | 데이터 접근 | 데이터 접근에 집중 |
+| **Service** | 비즈니스 로직 | 비즈니스 로직에 집중 |
+| **Controller** | 요청 라우팅 | 요청/응답 처리에 집중 |
+| **DTO/Schema** | 데이터 전송 구조 | 데이터 전송에 집중 |
 
 ### 프론트엔드 컴포넌트별 책임
 
-| 유형 | 책임 | 금지 |
-|------|------|------|
-| **Page** | 레이아웃, 데이터 fetch | 복잡한 로직 |
-| **Container** | 상태 관리, API 호출 | 과도한 UI |
-| **Presentational** | UI 렌더링 | API 호출, 전역 상태 |
-| **Hook** | 특정 로직 캡슐화 | 여러 책임 혼합 |
-| **Store** | 전역 상태 | UI 로직 |
+| 유형 | 책임 | 전담 영역 |
+|------|------|----------|
+| **Page** | 레이아웃, 데이터 fetch | 레이아웃과 fetch에 집중 |
+| **Container** | 상태 관리, API 호출 | 상태/API에 집중 |
+| **Presentational** | UI 렌더링 | UI 렌더링에 집중 (props로 데이터 수신) |
+| **Hook** | 특정 로직 캡슐화 | 단일 로직에 집중 |
+| **Store** | 전역 상태 | 상태 관리에 집중 |
 
 ---
 
@@ -41,31 +43,45 @@ estimated_tokens: ~500
 
 | 규칙 | 설명 |
 |------|------|
-| **순환 의존 금지** | A → B → A 형태 금지 |
-| **상위 모듈 의존 금지** | shared는 도메인 모듈 의존 금지 |
-| **인터페이스로 의존** | 구체 클래스 대신 추상화에 의존 |
+| **단방향 의존 유지** | A → B 단방향으로 유지 (순환 구조 대신) |
+| **상위 모듈은 독립적으로 유지** | shared는 도메인 모듈과 독립 유지 |
+| **인터페이스에 의존** | 구체 클래스 대신 추상화에 의존 |
 | **공개 API 통해 접근** | index.ts를 통한 export만 사용 |
 
 ### 백엔드
 
+<examples>
+<example type="good">
 ```typescript
 // 토큰 기반 주입 / 인터페이스 의존
 @Inject(PRODUCT_REPOSITORY)
 private readonly repository: IProductRepository
-
-// 구체 클래스 직접 의존 금지
+```
+</example>
+<example type="bad">
+```typescript
+// ❌ 구체 클래스 직접 의존
 private readonly repository: ProductRepository
 ```
+</example>
+</examples>
 
 ### 프론트엔드
 
+<examples>
+<example type="good">
 ```typescript
 // props로 의존성 전달
 function ProductCard({ product, onAction }: Props) { ... }
-
-// 전역 상태 직접 접근 (Presentational에서) 금지
+```
+</example>
+<example type="bad">
+```typescript
+// ❌ Presentational에서 전역 상태 직접 접근
 const action = useStore(s => s.action);
 ```
+</example>
+</examples>
 
 ---
 
@@ -99,7 +115,7 @@ src/
 │   │   ├── product.dto.ts
 │   │   └── product.module.ts
 │   └── order/
-└── shared/              # 공통 (상위 의존 금지)
+└── shared/              # 공통 (도메인 모듈과 독립 유지)
 ```
 
 ```
@@ -109,20 +125,26 @@ src/
 │   │   ├── ProductCard.tsx
 │   │   ├── ProductList.tsx
 │   │   └── index.ts
-│   └── common/          # 공통 (도메인 의존 금지)
+│   └── common/          # 공통 (도메인과 독립 유지)
 ├── hooks/               # 도메인별 hook
 ├── store/               # 전역 상태
 └── shared/              # 유틸리티
 ```
 
+</rules>
+
 ---
 
+<rules>
+
 ## 가독성 규칙
 
 ### try-catch vs then-catch
 
 > **Promise 처리 시 `then-catch` 패턴을 사용한다.**
 
+<examples>
+<example type="bad">
 ```typescript
 // ❌ try-catch (가독성 저하)
 async function fetchUser(id: string) {
@@ -133,7 +155,10 @@ async function fetchUser(id: string) {
     throw new NotFoundException('User not found');
   }
 }
-
+```
+</example>
+<example type="good">
+```typescript
 // ✅ then-catch (가독성 향상)
 function fetchUser(id: string) {
   return userService.findById(id)
@@ -143,17 +168,24 @@ function fetchUser(id: string) {
     });
 }
 ```
+</example>
+</examples>
 
 ### 삼항연산자 규칙
 
-> **삼항연산자에서 인자가 2개 이상인 함수를 호출하지 않는다.**
+> **삼항연산자에서 인자가 2개 이상인 함수 호출은 변수로 분리한다.**
 
+<examples>
+<example type="bad">
 ```typescript
 // ❌ 삼항연산자 내 복잡한 함수 호출
 const result = isAdmin
   ? processAdminData(data, options, config)
   : processUserData(data, options);
-
+```
+</example>
+<example type="good">
+```typescript
 // ✅ 변수로 분리 후 사용
 const processor = isAdmin ? processAdminData : processUserData;
 const result = processor(data, options, config);
@@ -166,19 +198,27 @@ if (isAdmin) {
   result = processUserData(data, options);
 }
 ```
+</example>
+</examples>
 
 **삼항연산자 허용 케이스:**
 - 단순 값 선택: `const name = isKorean ? '홍길동' : 'John';`
 - 인자 없는/1개 함수: `const value = isValid ? getValue() : getDefault();`
 
+</rules>
+
 ---
 
+<checklist>
+
 ## 코드 작성 시 체크리스트
 
 - [ ] 이 파일의 책임은 하나인가?
-- [ ] 다른 모듈에 불필요하게 의존하고 있지 않은가?
+- [ ] 다른 모듈에 불필요한 의존이 있는가? (있다면 제거)
 - [ ] 관련 파일들이 같은 폴더에 있는가?
-- [ ] 순환 의존이 발생하지 않는가?
+- [ ] 단방향 의존이 유지되는가?
 - [ ] 공개 API(index.ts)를 통해 접근하는가?
 - [ ] Promise 처리에 then-catch 패턴을 사용했는가?
-- [ ] 삼항연산자에서 복잡한 함수 호출을 피했는가?
+- [ ] 삼항연산자에서 복잡한 함수 호출을 변수로 분리했는가?
+
+</checklist>

package/{.claude → templates/global}/skills/Director/SKILL.md

@@ -74,14 +74,16 @@ keywords: [관련 키워드]
 
 | 축 | 검증 질문 | 예시 |
 |----|----------|------|
-| **기능 범위** | 기존 기능과 겹치거나 모순되지 않는가? | 결제 기능이 이미 존재하는데 별도 결제 모듈 추가 |
-| **비즈니스 규칙** | 기존 규칙과 충돌하는 조건이 없는가? | "주문 최소 금액 1만원" vs "0원 주문 허용" |
+| **기능 범위** | 기존 기능과 겹치거나 모순되는 부분이 있는가? | 결제 기능이 이미 존재하는데 별도 결제 모듈 추가 |
+| **비즈니스 규칙** | 기존 규칙과 충돌하는 조건이 있는가? | "주문 최소 금액 1만원" vs "0원 주문 허용" |
 | **데이터 모델** | 기존 모델 구조와 호환되는가? | 필수 필드 제거, 타입 변경 |
 | **UX 플로우** | 기존 사용자 플로우와 일관되는가? | 로그인 후 리다이렉트 경로 변경 |
-| **기술 제약** | 아키텍처/기술 스택 제약을 위반하지 않는가? | REST API에 GraphQL 엔드포인트 혼용 |
+| **기술 제약** | 아키텍처/기술 스택 제약을 준수하는가? | REST API에 GraphQL 엔드포인트 혼용 |
 
 ---
 
+<checklist>
+
 ## 충돌 탐지 체크리스트
 
 스펙 변경 시 아래 4가지 유형의 충돌을 확인합니다.
@@ -92,16 +94,18 @@ keywords: [관련 키워드]
 
 ### 2. 의존성 파괴
 - 변경이 다른 기능의 전제 조건을 깨뜨리는 경우
-- 예: 사용자 테이블 구조 변경 → 인증 모듈 파괴
+- 예: 사용자 테이블 구조 변경 -> 인증 모듈 파괴
 
 ### 3. 암묵적 충돌
 - 명시되지 않았지만 전제가 변경되어 발생하는 충돌
-- 예: 응답 포맷 변경 → 프론트엔드 파싱 실패
+- 예: 응답 포맷 변경 -> 프론트엔드 파싱 실패
 
 ### 4. 데이터 불일치
 - 같은 데이터를 다른 문서에서 다르게 정의
 - 예: A 문서에서 "status: string", B 문서에서 "status: enum"
 
+</checklist>
+
 ---
 
 ## 심각도 분류

package/{.claude → templates/global}/skills/Documentation/SKILL.md

@@ -2,7 +2,7 @@
 name: Documentation
 description: .claude 폴더 내 문서 생성/수정 시 사용. frontmatter 형식, Context/Skill/Agent 템플릿, 파일 분리 기준 제공.
 keywords: [문서, 작성, CLAUDE.md, context, skill, agent, frontmatter, 템플릿]
-estimated_tokens: ~800
+estimated_tokens: ~1200
 ---
 
 # .claude 문서 작성 스킬
@@ -119,10 +119,19 @@ estimated_tokens: ~300
 
 (필요시 코드 블록, 상세 설명)
 
+## 제약 사항
+
+<constraints>
+- 제약 1
+- 제약 2
+</constraints>
+
 ## 관련 파일
 
+<reference>
 - `path/to/related.md` - 설명
 - `src/module/` - 관련 소스 코드
+</reference>
 ```
 
 ### Skill 템플릿
@@ -139,25 +148,33 @@ estimated_tokens: ~400
 
 ## 핵심 역할
 
+<instructions>
 - 역할 1
 - 역할 2
+</instructions>
 
 ## 필수 준수 사항
 
+<rules>
 | 규칙 | 올바른 예 | 잘못된 예 |
 |------|----------|----------|
 | ... | ... | ... |
+</rules>
 
 ## 코드 예제
 
+<examples>
 \`\`\`typescript
 // 올바른 패턴
 \`\`\`
+</examples>
 
 ## 체크리스트
 
+<checklist>
 - [ ] 확인 항목 1
 - [ ] 확인 항목 2
+</checklist>
 
 ## 관련 문서
 
@@ -179,16 +196,19 @@ color: blue
 
 # Agent 이름
 
+<role>
 ## 역할
 
 1. 첫 번째 역할
 2. 두 번째 역할
+</role>
 
 ## 언제 사용하는가
 
 - 사용 시점 1
 - 사용 시점 2
 
+<instructions>
 ## 프로세스
 
 ### Step 1: 준비
@@ -196,7 +216,16 @@ color: blue
 
 ### Step 2: 실행
 ...
+</instructions>
+
+<constraints>
+## 제약 사항
 
+- 이 Agent는 A만 전담한다
+- B 작업은 other-agent에 위임한다
+</constraints>
+
+<output_format>
 ## 출력 형식
 
 \`\`\`markdown
@@ -205,6 +234,7 @@ color: blue
 ## 요약
 ...
 \`\`\`
+</output_format>
 ```
 
 ## 인덱스 파일 작성법
@@ -272,6 +302,43 @@ keywords:
 - frontmatter 누락
 - 모호한 keywords
 
+## 프롬프트 구조화 (XML 태그)
+
+문서에 XML 태그를 사용하면 Claude가 지시/규칙/제약을 정확히 구분하여 준수율이 높아집니다.
+
+### 파일 유형별 권장 XML 태그
+
+| 파일 유형 | 필수 태그 | 선택 태그 |
+|----------|----------|----------|
+| Agent | `<role>`, `<instructions>`, `<constraints>`, `<output_format>` | `<rules>`, `<examples>`, `<reference>` |
+| Skill | `<instructions>`, `<rules>`, `<checklist>` | `<examples>`, `<constraints>`, `<reference>` |
+| CLAUDE.md | `<workflow>`, `<delegation_rules>`, `<constraints>` | `<rules>`, `<reference>` |
+| Hook | `<phase name="...">`, `<checklist>` | `<delegation_rules>`, `<rules>` |
+
+### 긍정 표현 원칙
+
+프롬프트는 부정 표현 대신 긍정 표현으로 작성합니다.
+
+| 부정 표현 (비권장) | 긍정 표현 (권장) |
+|-------------------|-----------------|
+| "직접 수정하지 마라" | "모든 수정은 code-writer가 전담한다" |
+| "Git 명령어 실행 금지" | "Git 작업은 git-manager에 위임한다" |
+| "3개 이상 파일 수정 금지" | "파일 수정은 2개 이하만 직접 수행한다" |
+
+- 제약은 "~만 한다", "~전용", "~전담" 형태로 표현
+- 대안 행동을 구체적으로 명시 (무엇을 대신 해야 하는지)
+
+### XML 태그 사용 규칙
+
+1. **섹션 경계를 명확히**: 태그는 논리적 블록 단위로 감싼다
+2. **중첩 최소화**: 2단계 이상 중첩은 지양한다
+3. **태그 이름 통일**: 위 테이블의 태그명을 일관되게 사용한다
+4. **Markdown과 병행**: 태그 안에서 Markdown 서식을 그대로 사용한다
+
+> 상세 가이드: `.claude/skills/PromptStructuring/`
+
+---
+
 ## 체크리스트
 
 ### 새 파일 작성 시

package/{.claude → templates/global}/skills/Git/SKILL.md

@@ -14,6 +14,8 @@ estimated_tokens: ~100
 - PR/MR 코드 리뷰
 - 리뷰 피드백 반영
 
+<reference>
+
 ## 관련 문서
 
 | 주제 | 위치 | 설명 |
@@ -22,6 +24,8 @@ estimated_tokens: ~100
 | PR 리뷰 | `pr-review.md` | 체크리스트 기반 코드 리뷰 워크플로우 |
 | PR 피드백 적용 | `pr-apply.md` | 리뷰 피드백 분류 및 반영 방법 |
 
+</reference>
+
 ## 빠른 참조
 
 ### Commit PREFIX
@@ -45,10 +49,10 @@ estimated_tokens: ~100
 
 | 섹션 | 설명 |
 |------|------|
-| 📋 Summary | 핵심 변경 1-2문장 요약 |
-| 🔄 주요 변경사항 | 파일별 변경 내용 |
-| ⚠️ 사이드 이펙트 | 다른 영역 영향 분석 |
-| 🔀 변경 흐름 | mermaid 다이어그램 (선택) |
+| Summary | 핵심 변경 1-2문장 요약 |
+| 주요 변경사항 | 파일별 변경 내용 |
+| 사이드 이펙트 | 다른 영역 영향 분석 |
+| 변경 흐름 | mermaid 다이어그램 (선택) |
 
 ### PR 워크플로우
 

package/{.claude → templates/global}/skills/Git/git.md

@@ -7,6 +7,8 @@ estimated_tokens: ~600
 
 # Git 작업 가이드
 
+<rules>
+
 ## Commit 메시지
 
 ### 형식
@@ -34,7 +36,7 @@ Co-Authored-By: Claude <noreply@anthropic.com>
 ### 작성 원칙
 
 - **한글 사용**, 50자 이내
-- **현재형**: "추가함" → "추가"
+- **현재형**: "추가함" 대신 "추가"
 - **Why 중심**: 무엇보다 왜 변경했는지
 
 ### Commit 단위
@@ -43,6 +45,8 @@ Co-Authored-By: Claude <noreply@anthropic.com>
 - 각 커밋 후 빌드 에러 없음
 - 되돌리기 용이한 단위
 
+</rules>
+
 ---
 
 ## 브랜치 전략
@@ -56,6 +60,8 @@ chore/{작업명}       # 설정/빌드
 
 ---
 
+<instructions>
+
 ## PR (Pull Request) 생성
 
 ### Step 1: 변경사항 분석
@@ -121,11 +127,11 @@ grep -r "import.*변경된함수명" --include="*.ts" --include="*.tsx"
 ### Step 4: PR 본문 작성
 
 ```markdown
-## 📋 Summary
+## Summary
 
 > 이 PR이 해결하는 문제와 접근 방식을 1-2문장으로 설명
 
-## 🔄 주요 변경사항
+## 주요 변경사항
 
 ### [변경 제목 1]
 **파일:** `path/to/file.ts`
@@ -135,7 +141,7 @@ grep -r "import.*변경된함수명" --include="*.ts" --include="*.tsx"
 **파일:** `path/to/file.ts`
 - 변경 내용 설명
 
-## ⚠️ 사이드 이펙트
+## 사이드 이펙트
 
 > 이 변경으로 인해 다른 부분에 발생할 수 있는 영향
 
@@ -143,7 +149,7 @@ grep -r "import.*변경된함수명" --include="*.ts" --include="*.tsx"
 |---------------|----------|--------|
 | 없음 | - | - |
 
-## 🔀 변경 흐름
+## 변경 흐름
 
 ```mermaid
 graph LR
@@ -166,20 +172,24 @@ EOF
 )"
 ```
 
+</instructions>
+
 ---
 
-## Git 명령어 주의사항
+<rules>
 
-### 금지
+## Git 명령어 안전 규칙
 
-| 명령어 | 이유 |
+### 사용 제한 명령어
+
+| 명령어 | 대안 |
 |--------|------|
-| `git add -A`, `git add .` | 민감 파일 포함 위험 |
-| `git push --force` | 히스토리 손상 |
-| `git reset --hard` | 작업 손실 위험 |
-| `--no-verify` | hook 우회 금지 |
+| `git add -A`, `git add .` | 파일을 지정하여 `git add path/to/file` 사용 |
+| `git push --force` | `git push` 또는 `--force-with-lease` 사용 |
+| `git reset --hard` | `git stash` 또는 `git checkout -- file` 사용 |
+| `--no-verify` | hook을 통과하도록 코드 수정 |
 
-### 권장
+### 권장 패턴
 
 ```bash
 # 파일 지정하여 add
@@ -196,8 +206,12 @@ EOF
 )"
 ```
 
+</rules>
+
 ---
 
+<checklist>
+
 ## PR 생성 전 체크리스트
 
 - [ ] `lint` 통과
@@ -207,8 +221,12 @@ EOF
 - [ ] 영향 범위 분석 완료
 - [ ] Breaking change 명시 (해당시)
 
+</checklist>
+
 ---
 
+<instructions>
+
 ## PR 생성 후 워크플로우
 
 ### Step 6: Self PR Review
@@ -227,15 +245,19 @@ gh pr view <PR번호>
 
 | 항목 | 확인 |
 |------|------|
-| 불필요한 코드/주석 제거 | ☐ |
-| 디버그 코드 제거 (console.log 등) | ☐ |
-| 하드코딩된 값 없음 | ☐ |
-| 타입 안전성 확인 | ☐ |
-| 에러 핸들링 적절함 | ☐ |
-| 네이밍 컨벤션 준수 | ☐ |
+| 불필요한 코드/주석 제거 | |
+| 디버그 코드 제거 (console.log 등) | |
+| 하드코딩된 값 확인 | |
+| 타입 안전성 확인 | |
+| 에러 핸들링 적절함 | |
+| 네이밍 컨벤션 준수 | |
+
+<reference>
 
 > 상세 체크리스트: `.claude/skills/Git/pr-review.md`
 
+</reference>
+
 **Self Review 이슈 발견 시:**
 
 ```bash
@@ -287,30 +309,40 @@ git push
 gh pr comment <PR번호> --body "리뷰 피드백 반영 완료. 재확인 부탁드립니다."
 ```
 
+<reference>
+
 > 상세 가이드: `.claude/skills/Git/pr-apply.md`
 
+</reference>
+
+</instructions>
+
 ---
 
 ## 전체 PR 워크플로우 요약
 
 ```mermaid
 graph TD
-  A[📊 변경사항 분석] --> B[🔍 영향 범위 분석]
-  B --> C[⚖️ 영향 판단]
-  C --> D[✍️ PR 본문 작성]
-  D --> E[🚀 PR 생성]
-  E --> F[🔎 Self PR Review]
-  F -->|이슈 발견| G[🔧 수정 & Push]
+  A[변경사항 분석] --> B[영향 범위 분석]
+  B --> C[영향 판단]
+  C --> D[PR 본문 작성]
+  D --> E[PR 생성]
+  E --> F[Self PR Review]
+  F -->|이슈 발견| G[수정 & Push]
   G --> F
-  F -->|OK| H[👥 팀원 리뷰 대기]
-  H -->|피드백| I[📝 PR Apply Mode]
+  F -->|OK| H[팀원 리뷰 대기]
+  H -->|피드백| I[PR Apply Mode]
   I --> H
-  H -->|Approve| J[✅ Merge]
+  H -->|Approve| J[Merge]
 ```
 
+<reference>
+
 ### 관련 Skill 참조
 
 | 단계 | Skill |
 |------|-------|
 | PR Review | `.claude/skills/Git/pr-review.md` |
 | PR Apply | `.claude/skills/Git/pr-apply.md` |
+
+</reference>

package/{.claude → templates/global}/skills/Git/pr-apply.md

@@ -10,6 +10,8 @@ user-invocable: true
 
 PR 리뷰 피드백을 코드에 반영하는 가이드.
 
+<instructions>
+
 ## Apply Workflow
 
 ### Step 1: 리뷰 피드백 확인
@@ -58,6 +60,10 @@ git push origin feature/branch-name
 gh pr comment <PR번호> --body "리뷰 피드백 반영 완료했습니다. 재확인 부탁드립니다."
 ```
 
+</instructions>
+
+<rules>
+
 ## 피드백 대응 원칙
 
 ### 수용할 때
@@ -77,11 +83,17 @@ gh pr comment <PR번호> --body "리뷰 피드백 반영 완료했습니다. 재
 - 해당 코멘트에 직접 답변
 - 필요시 코드에 주석 추가
 
+</rules>
+
+<checklist>
+
 ## 체크리스트
 
-- [ ] 모든 Critical 피드백 반영
-- [ ] Suggestion 검토 및 결정
-- [ ] Question 답변 완료
-- [ ] `lint` 통과
-- [ ] `build` 성공
-- [ ] 리뷰어에게 재확인 요청
+- [ ] 모든 Critical 피드백을 반영했는가?
+- [ ] Suggestion을 검토하고 결정했는가?
+- [ ] Question에 답변을 완료했는가?
+- [ ] `lint` 통과하는가?
+- [ ] `build` 성공하는가?
+- [ ] 리뷰어에게 재확인을 요청했는가?
+
+</checklist>

package/{.claude → templates/global}/skills/Git/pr-review.md

@@ -10,6 +10,8 @@ user-invocable: true
 
 체크리스트 기반 Pull Request 리뷰.
 
+<instructions>
+
 ## Review Workflow
 
 ### Step 1: Review Plan 작성
@@ -58,6 +60,8 @@ user-invocable: true
 ### Highlights (좋은 점)
 ```
 
+</instructions>
+
 ## PR 타입별 Focus
 
 | Type | Focus Areas |