jun-claude-code 0.0.11 → 0.0.13

package/{.claude → templates/global}/agents/task-planner.md

@@ -8,22 +8,24 @@ color: green
 
 # Task Planner Agent
 
-TaskList를 생성하고 코드 수정 계획을 작성하는 전문 Agent입니다.
-
-## 핵심 원칙
+<role>
 
-**애매한 요구사항은 절대 추측하지 않습니다.**
-구체적이지 않은 부분은 반드시 사용자에게 질문하여 명확히 한 후 작업합니다.
+TaskList를 생성하고 코드 수정 계획을 작성하는 전문 Agent입니다.
 
-## 역할
+**애매한 요구사항은 반드시 사용자에게 확인한 후 진행합니다.**
+구체적이지 않은 부분은 질문하여 명확히 한 후 작업합니다.
 
 1. **요구사항 분석**: 사용자 요청의 명확성 검증
 2. **명확화 질문**: 애매한 부분에 대한 적극적 질문
 3. **TaskList 생성**: 작업을 작은 단위로 분해
 4. **코드 수정 계획**: 파일별 변경사항 정리
 
+</role>
+
 ---
 
+<instructions>
+
 ## Phase 1: 요구사항 명확화 (필수)
 
 ### 체크리스트 - 아래 항목이 명확한가?
@@ -125,9 +127,11 @@ TaskList를 생성하고 코드 수정 계획을 작성하는 전문 Agent입니
 ...
 ```
 
+</instructions>
+
 ---
 
-## 출력 형식
+<output_format>
 
 ```markdown
 # Task Planning 결과
@@ -151,10 +155,14 @@ TaskList를 생성하고 코드 수정 계획을 작성하는 전문 Agent입니
 - impact-analyzer Agent로 사이드이펙트 검증 권장
 ```
 
+</output_format>
+
 ---
 
-## 중요
+<constraints>
 
-- **추측 금지**: 불확실하면 반드시 질문
-- **과도한 계획 금지**: 필요한 만큼만 계획
+- **불확실한 사항은 확인 후 진행**: 애매한 요구사항은 반드시 사용자에게 질문
+- **필요한 범위만 계획**: 현재 작업에 필요한 만큼만 계획 수립
 - **유연성 유지**: 구현 중 발견되는 사항은 계획 수정 가능
+
+</constraints>

package/{.claude → templates/global}/hooks/skill-forced.sh

@@ -14,71 +14,65 @@ echo "✅ [Hook] Skill/Agent 평가 프로토콜 실행됨"
 cat << 'EOF'
 MANDATORY SKILL & AGENT EVALUATION PROTOCOL
 
-작업을 시작하기 전에 반드시 아래 단계를 순서대로 완료하세요:
+작업을 시작하기 전에 아래 단계를 순서대로 완료하세요:
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-⚠️ CONTEXT 절약 원칙 (최우선 - 반드시 준수) ⚠️
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+<delegation_rules>
+
+## CONTEXT 절약 원칙 (최우선)
 
 Main Agent의 Context Window는 제한적입니다.
-**Subagent가 할 수 있는 작업은 반드시 Subagent에 위임하세요!**
-
-### 🚨 필수 위임 작업 (Main Agent 직접 수행 금지)
-
-| 작업 유형 | 사용할 Agent | 이유 |
-|----------|-------------|------|
-| 코드베이스 탐색/검색 | explore | 파일 내용이 Main Context에 쌓이지 않음 |
-| 여러 파일 읽기 | explore / context-collector | 탐색 결과만 요약해서 받음 |
-| 패턴/구조 파악 | context-collector | 분석 결과만 받음 |
-| 복잡한 계획 수립 | task-planner | 계획 결과만 받음 |
-| 영향 분석 | impact-analyzer | 분석 결과만 받음 |
-| 코드 리뷰 | code-reviewer | 리뷰 결과만 받음 |
-| 테스트/빌드 검증 | qa-tester | 검증 결과만 받음 |
-| 단순 수정 (lint/build 오류, 오타, 설정값) | simple-code-writer | Main이 직접 수정하지 않음 |
-| 여러 파일 코드 작성 | code-writer / designer | 구현 결과만 받음 |
-| Git 작업 | git-manager | 커밋/PR 결과만 받음 |
-
-### ❌ 절대 금지 (Main Agent에서 직접 수행 금지)
-
-- Main Agent에서 직접 Glob/Grep으로 여러 파일 탐색
-- Main Agent에서 직접 여러 파일 Read (2개 이상)
-- Main Agent에서 복잡한 분석/계획 수행
-- Main Agent에서 3개 이상 파일 수정
-- **Main Agent에서 직접 Git 명령어 실행 (git add, commit, push 등)**
-- **Main Agent에서 직접 코드 수정 (Edit/Write로 코드 파일 수정 금지)**
-
-### ✅ Main Agent 허용 작업 (이것만 직접 수행)
+**Subagent가 할 수 있는 작업은 Subagent에 위임하세요.**
+
+### Subagent 전담 작업
+
+아래 PART 2의 "사용 가능한 Agents" 목록에서 각 Agent의 description을 확인하고,
+작업에 적합한 Agent에 위임하세요. 각 Agent의 description에 위임 이유가 포함되어 있습니다.
+
+### Subagent 전용 작업
+
+| 작업 | 전담 Agent |
+|------|-----------|
+| 파일 탐색 (Glob/Grep) | explore Agent가 전담 |
+| 2개 이상 파일 읽기 | explore/context-collector가 전담 |
+| 복잡한 분석/계획 | task-planner에 위임 |
+| 파일 수정 (3개 이상) | code-writer가 전담 |
+| Git 명령어 실행 (git add, commit, push 등) | git-manager에 위임 |
+| 코드 수정 (Edit/Write) | code-writer/simple-code-writer에 위임 |
+
+### Main Agent 전담 작업
 
 - 사용자와 대화/질문 응답
 - Task 흐름 관리 (TaskCreate, TaskUpdate, TaskList)
 - Subagent 호출 및 결과 전달
-- 단순 명령 실행 (Bash) - **단, Git/코드수정 명령어 제외**
+- 단순 명령 실행 (Bash) - **Git/코드수정은 Subagent 전담**
 
-### 🔒 Git 작업은 반드시 Subagent 사용 (필수)
+### Git 작업은 git-manager 전담
 
-**모든 Git 작업은 `git-manager` Agent에 위임하세요!**
+**모든 Git 작업은 `git-manager` Agent에 위임하세요.**
 
 \`\`\`
 Task(subagent_type="git-manager", prompt="현재 변경사항을 커밋해줘")
 Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 \`\`\`
 
-| Git 작업 | 위임 필수 | 이유 |
+| Git 작업 | 전담 여부 | 이유 |
 |----------|----------|------|
-| 단순 커밋 | **필수** | 커밋 규칙 자동 준수 |
-| PR 생성 | **필수** | PR 템플릿 자동 적용 |
-| 브랜치 관리 | **필수** | 안전 규칙 자동 적용 |
+| 단순 커밋 | **전담** | 커밋 규칙 자동 준수 |
+| PR 생성 | **전담** | PR 템플릿 자동 적용 |
+| 브랜치 관리 | **전담** | 안전 규칙 자동 적용 |
 
-### 💡 왜 Subagent를 사용해야 하는가?
+### 왜 Subagent를 사용해야 하는가?
 
 1. **Context 절약**: Subagent의 탐색/분석 결과는 요약되어 Main에 전달
 2. **대화 지속성**: Main Context가 절약되어 더 긴 대화 가능
 3. **전문성**: 각 Agent는 특정 작업에 최적화됨
 4. **병렬 처리**: 여러 Agent를 동시에 실행 가능
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PART 1: SKILL 평가
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+</delegation_rules>
+
+<phase name="Skill 평가">
+
+## PART 1: SKILL 평가
 
 Step 1 - Skill 평가: 각 Skill에 대해 다음을 명시하세요:
   - Skill 이름
@@ -91,6 +85,7 @@ Step 2 - Skill 활성화: YES로 표시된 모든 Skill의 SKILL.md를 읽으세
 
 ### 사용 가능한 Skills (자동 탐색됨)
 
+</phase>
 EOF
 
 # skills 폴더에서 SKILL.md 파일들의 frontmatter 자동 탐색
@@ -129,20 +124,22 @@ done
 
 cat << 'EOF'
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PART 1.5: CONTEXT 확인 (Subagent로 위임 권장)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+<phase name="Context 확인">
+
+## PART 1.5: CONTEXT 확인 (Subagent 위임 권장)
 
 **권장:** Context 확인은 `context-collector` Agent에 위임하세요.
-직접 여러 파일을 읽으면 Main Context가 낭비됩니다.
+여러 파일을 직접 읽는 대신, Subagent가 요약하여 전달합니다.
 
 ```
 Task(subagent_type="context-collector", prompt="[작업 설명]에 필요한 Context를 수집하고 요약해줘")
 ```
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PART 2: AGENT 평가 (필수 - Context 절약)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+</phase>
+
+<phase name="Agent 평가">
+
+## PART 2: AGENT 평가 (Context 절약 핵심)
 
 Step 3 - Agent 평가: 각 Agent에 대해 다음을 명시하세요:
   - Agent 이름
@@ -156,6 +153,7 @@ Step 4 - Agent 활용: YES로 표시된 Agent는 Task 도구로 호출하세요.
 
 ### 사용 가능한 Agents (자동 탐색됨)
 
+</phase>
 EOF
 
 # agents 폴더에서 agent 파일들의 frontmatter 자동 탐색
@@ -196,19 +194,21 @@ done
 
 cat << 'EOF'
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PART 3: 구현
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+<phase name="구현">
+
+## PART 3: 구현
 
-Step 5 - 구현: 모든 관련 Skill 확인 및 Agent 호출 후에만 구현을 시작하세요.
+Step 5 - 구현: 모든 관련 Skill 확인 및 Agent 호출 후에 구현을 시작하세요.
 
 ---
 
-### 중요
+### 핵심 원칙
 
-- **탐색 작업은 반드시 Subagent로**: Main Context 절약
-- **구현 후 검증은 필수**: code-reviewer + qa-tester
+- **탐색 작업은 Subagent 전담**: Main Context 절약
+- **구현 후 검증 수행**: code-reviewer + qa-tester
 - **단순 작업은 예외**: 설정 파일 수정, 오타 수정은 직접 처리 가능
 
 지금 바로 모든 사용 가능한 Skill과 Agent를 평가하세요.
+
+</phase>
 EOF

package/{.claude → templates/global}/hooks/workflow-enforced.sh

@@ -12,16 +12,16 @@ PROJECT_CLAUDE_DIR="$(pwd)/.claude"
 echo "✅ [Hook] 워크플로우 순서 강제 프로토콜 실행됨"
 
 cat << 'EOF'
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 MANDATORY WORKFLOW SEQUENCE PROTOCOL
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-코드 작업 시 반드시 아래 Phase 순서를 따르세요.
-각 Phase를 건너뛰거나 순서를 바꾸지 마세요.
+코드 작업 시 아래 Phase 순서를 따르세요.
+각 Phase를 순서대로 완료한 후 다음 Phase로 진행하세요.
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PHASE 1: 계획 (Planning) - 구현 전 필수
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+<phase name="계획">
+
+## PHASE 1: 계획 (Planning) - 구현 전 필수
+
+<checklist>
 
 ### Step 1.1: Context 수집
 
@@ -47,15 +47,21 @@ PHASE 1: 계획 (Planning) - 구현 전 필수
 - [ ] 각 파일의 변경 내용 요약
 - [ ] 예상되는 영향 범위
 
-### Step 1.4: 사용자 Confirm 받기 ⚠️ 필수
+### Step 1.4: 사용자 Confirm 받기 -- 필수
 
 중요: 계획을 사용자에게 보여주고 승인받은 후에만 구현 진행
 - ExitPlanMode 사용 (Plan Mode인 경우)
 - 또는 계획 내용을 명시적으로 보여주고 확인 요청
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PHASE 2: 검증 (Validation) - 구현 전 필수
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+</checklist>
+
+</phase>
+
+<phase name="검증">
+
+## PHASE 2: 검증 (Validation) - 구현 전 필수
+
+<checklist>
 
 ### Step 2.1: 사이드이펙트 검증
 
@@ -66,27 +72,39 @@ PHASE 2: 검증 (Validation) - 구현 전 필수
 
 도구: impact-analyzer Agent (복잡한 경우)
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PHASE 3: 구현 (Implementation)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+</checklist>
+
+</phase>
+
+<phase name="구현">
+
+## PHASE 3: 구현 (Implementation)
+
+<checklist>
 
 ### Step 3.1: 작은 단위로 코드 수정
 
 필수 원칙:
 - [ ] 독립적으로 빌드 가능한 단위로 작업
 - [ ] 한 번에 하나의 기능/수정만 진행
-- [ ] 빌드 에러가 발생하지 않는 상태 유지
+- [ ] 빌드 가능 상태를 유지
 
 ### Step 3.2: 단위별 커밋
 
 필수 규칙:
-- [ ] 수정한 파일만 git add (git add -A 금지 ⚠️)
+- [ ] 수정한 파일만 개별 지정하여 git add
 - [ ] 명확한 커밋 메시지 작성 (Git Skill 참조)
 - [ ] 커밋 단위: 하나의 논리적 변경
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-PHASE 4: 리뷰 (Review) - 구현 후 필수
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+</checklist>
+
+</phase>
+
+<phase name="리뷰">
+
+## PHASE 4: 리뷰 (Review) - 구현 후 필수
+
+<checklist>
 
 ### Step 4.1: Self Code Review
 
@@ -102,18 +120,20 @@ PHASE 4: 리뷰 (Review) - 구현 후 필수
 필수 확인:
 - [ ] 원래 요청사항이 모두 충족되었는지 확인
 - [ ] 예상한 동작이 구현되었는지 확인
-- [ ] 누락된 엣지케이스 없는지 점검
+- [ ] 모든 엣지케이스가 처리되었는지 점검
+
+</checklist>
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-워크플로우 요약
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+</phase>
+
+### 워크플로우 요약
 
 ┌─────────────────────────────────────────────────────────────┐
 │  PHASE 1: 계획                                              │
 │  ├─ 1.1 Context 수집                                        │
 │  ├─ 1.2 TaskList 생성                                       │
 │  ├─ 1.3 수정 계획 작성                                       │
-│  └─ 1.4 사용자 Confirm ⚠️                                   │
+│  └─ 1.4 사용자 Confirm                                      │
 │                        ↓                                    │
 │  PHASE 2: 검증                                              │
 │  └─ 2.1 사이드이펙트 검증 (Code Flow, UserFlow)              │
@@ -127,9 +147,9 @@ PHASE 4: 리뷰 (Review) - 구현 후 필수
 │  └─ 4.2 Task 완료 검증                                      │
 └─────────────────────────────────────────────────────────────┘
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-참조 가능한 Skills (자동 탐색됨)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
+
+### 참조 가능한 Skills (자동 탐색됨)
 
 EOF
 
@@ -169,9 +189,7 @@ done
 
 cat << 'EOF'
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-예외 상황
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+### 예외 상황
 
 다음의 경우 Phase를 축소/생략 가능:
 - 단순 오타 수정
@@ -179,5 +197,5 @@ cat << 'EOF'
 - 1-2줄 변경
 - 사용자가 명시적으로 빠른 수정 요청
 
-그 외 모든 코드 작업은 반드시 위 순서를 따르세요.
+그 외 모든 코드 작업은 위 순서를 따르세요.
 EOF

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

@@ -7,6 +7,8 @@ estimated_tokens: ~400
 
 # 백엔드 개발 원칙
 
+<rules>
+
 ## 레이어 간 객체 변환 규칙
 
 > **객체 변환은 필요한 시점에 해당 레이어에서 수행한다.**
@@ -15,12 +17,16 @@ estimated_tokens: ~400
 
 | 레이어 | 입력 | 출력 | 변환 책임 |
 |--------|------|------|----------|
-| **Controller** | Request DTO | Response DTO/Schema | Entity → Response 변환 |
-| **Service** | DTO (그대로 사용) | Entity 또는 일반 객체 | DTO → Entity 변환 (필요시) |
+| **Controller** | Request DTO | Response DTO/Schema | Entity -> Response 변환 |
+| **Service** | DTO (그대로 사용) | Entity 또는 일반 객체 | DTO -> Entity 변환 (필요시) |
 | **Repository** | Entity | Entity | 없음 |
 
-### Controller → Service 호출
+</rules>
+
+### Controller -> Service 호출
 
+<examples>
+<example type="bad">
 ```typescript
 // ❌ Controller에서 미리 Entity로 변환
 @Post()
@@ -30,13 +36,18 @@ async create(@Body() dto: CreateUserDto) {
   entity.email = dto.email;
   return this.userService.create(entity);  // Entity 전달
 }
-
+```
+</example>
+<example type="good">
+```typescript
 // ✅ DTO 그대로 전달
 @Post()
 async create(@Body() dto: CreateUserDto) {
   return this.userService.create(dto);  // DTO 전달
 }
 ```
+</example>
+</examples>
 
 ### Service 내부 처리
 
@@ -55,7 +66,7 @@ async create(dto: CreateUserDto) {
 }
 ```
 
-### Service → Controller 반환
+### Service -> Controller 반환
 
 ```typescript
 // ✅ Service: Entity 또는 일반 객체 반환
@@ -79,9 +90,11 @@ async findOne(@Param('id') id: number) {
 
 ---
 
+<rules>
+
 ## TypeORM 사용 규칙
 
-> **find 메서드를 기본으로 사용하고, QueryBuilder는 꼭 필요한 경우에만 사용한다.**
+> **find 메서드를 기본으로 사용하고, QueryBuilder는 필요한 경우에만 사용한다.**
 
 ### find 메서드 우선 사용
 
@@ -115,6 +128,10 @@ const users = await this.userRepository.find({
 | **복잡한 서브쿼리** | 중첩 쿼리 |
 | **복잡한 JOIN 조건** | ON 절 커스텀 |
 
+</rules>
+
+<examples>
+<example type="good">
 ```typescript
 // ✅ QueryBuilder 허용: groupBy + getRawMany
 const stats = await this.orderRepository
@@ -124,24 +141,36 @@ const stats = await this.orderRepository
   .addSelect('SUM(order.amount)', 'total')
   .groupBy('order.status')
   .getRawMany();
-
+```
+</example>
+<example type="bad">
+```typescript
 // ❌ 불필요한 QueryBuilder 사용
 const user = await this.userRepository
   .createQueryBuilder('user')
   .where('user.id = :id', { id })
   .getOne();
-
+```
+</example>
+<example type="good">
+```typescript
 // ✅ find로 대체
 const user = await this.userRepository.findOneBy({ id });
 ```
+</example>
+</examples>
 
 ---
 
+<checklist>
+
 ## 체크리스트
 
-- [ ] Controller에서 Entity로 변환하지 않고 DTO를 그대로 Service에 전달하는가?
+- [ ] Controller에서 DTO를 그대로 Service에 전달하는가? (Entity 변환은 Service에서)
 - [ ] Service에서 Entity가 필요한 시점에 변환하는가?
 - [ ] Service의 return은 Entity 또는 일반 객체인가?
 - [ ] Controller에서 Response DTO/Schema로 변환하는가?
 - [ ] TypeORM find 메서드를 우선 사용하는가?
 - [ ] QueryBuilder는 groupBy, getRawMany 등 필요한 경우에만 사용하는가?
+
+</checklist>