jun-claude-code 0.0.7 → 0.0.9

package/.claude/CLAUDE.md

@@ -18,6 +18,7 @@ Main Agent의 Context Window는 제한적입니다.
 | 영향 분석 | `impact-analyzer` | 분석 결과만 받음 |
 | 코드 리뷰 | `code-reviewer` | 리뷰 결과만 받음 |
 | 테스트/빌드 검증 | `qa-tester` | 검증 결과만 받음 |
+| 간단한 코드 수정 | `simple-code-writer` | 1-2개 파일도 Main이 직접 수정하지 않음 |
 | 여러 파일 코드 작성 | `code-writer` | 구현 결과만 받음 |
 | Git 작업 | `git-manager` | 커밋/PR 결과만 받음 |
 | Context 문서 정리 | `context-manager` | 파일 분리, 토큰 최적화 |
@@ -29,13 +30,24 @@ Main Agent의 Context Window는 제한적입니다.
 - Main Agent에서 복잡한 분석/계획 수행
 - Main Agent에서 3개 이상 파일 수정
 - **Main Agent에서 직접 Git 명령어 실행 (git add, commit, push 등)**
+- **Main Agent에서 직접 코드 수정 (Edit/Write로 코드 파일 수정)**
 
 ### Main Agent 허용 작업 (이것만 직접 수행)
 
-- 단일~소수(1-2개) 파일 수정 (Edit)
-- 단일~소수(1-2개) 파일 생성 (Write)
-- 단순 명령 실행 (Bash) - **단, Git 명령어 제외**
 - 사용자와 대화/질문 응답
+- Task 흐름 관리 (TaskCreate, TaskUpdate, TaskList)
+- Subagent 호출 및 결과 전달
+- 단순 명령 실행 (Bash) - **단, Git 명령어 제외**
+
+### Main Agent 코드 수정 금지
+
+Main Agent는 **절대 코드를 직접 수정하지 않습니다.**
+모든 코드 수정은 Subagent에 위임하세요.
+
+| 수정 규모 | Agent | 모델 |
+|----------|-------|------|
+| 1-2개 파일 간단 수정 | `simple-code-writer` | haiku |
+| 3개 이상 파일 / 복잡한 수정 | `code-writer` | opus |
 
 ### Git 작업은 반드시 Subagent 사용
 
@@ -57,7 +69,7 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 
 | 상황 | 처리 |
 |------|------|
-| 1~2개 파일 수정/생성 | Main Agent 직접 처리 |
+| 1~2개 파일 간단 수정 | `simple-code-writer` Agent에 위임 |
 | 3개 이상 파일 수정/생성 | `code-writer` Agent에 위임 |
 | 여러 파일 대규모 리팩토링 | `code-writer` Agent에 위임 |
 

package/.claude/agents/git-manager.md

@@ -108,26 +108,36 @@ git diff main...HEAD
 git push -u origin <branch-name>
 
 # PR 생성
-gh pr create --title "<PREFIX>: <제목>" --body "$(cat <<'EOF'
-## 설명
+gh pr create --title "<간결한 제목>" --body "$(cat <<'EOF'
+## 📋 Summary
 
-[PR 설명]
+> 이 PR이 해결하는 문제와 접근 방식을 1-2문장으로 설명
 
-## 목표
+## 🔄 주요 변경사항
 
-[핵심 목표]
-
-## 변경사항
+### 변경 1: [제목]
+**파일:** `path/to/file.ts`
+- 변경 내용 설명
 
-### 1. [변경사항]
+### 변경 2: [제목]
 **파일:** `path/to/file.ts`
+- 변경 내용 설명
+
+## ⚠️ 사이드 이펙트
 
-**변경 내용:**
-- ...
+> 이 변경으로 인해 다른 부분에 발생할 수 있는 영향
 
-## 후속 작업 (선택)
+| 영향 받는 영역 | 영향 내용 | 위험도 |
+|---------------|----------|--------|
+| 없음 | - | - |
 
-- [ ] ...
+## 🔀 변경 흐름
+
+```mermaid
+graph LR
+  A[변경 시작점] --> B[영향 받는 모듈]
+  B --> C[최종 결과]
+```
 
 Generated with [Claude Code](https://claude.ai/code)
 
@@ -187,7 +197,7 @@ git status -sb
 
 ## PR 정보
 - **URL**: https://github.com/...
-- **제목**: FEAT: 기능 설명
+- **제목**: 기능 설명
 - **브랜치**: feature/xxx → main
 
 ## 포함된 커밋

package/.claude/agents/simple-code-writer.md

@@ -0,0 +1,52 @@
+---
+name: simple-code-writer
+description: 1-2개 파일의 간단한 코드 수정 시 호출. Main Agent 대신 단순 수정, 설정 변경, 오타 수정 등을 수행.
+keywords: [간단수정, 단순수정, 설정변경, 오타수정, 1-2파일, 소규모수정]
+model: haiku
+color: cyan
+---
+
+# Simple Code Writer Agent
+
+1-2개 파일의 간단한 코드 수정을 담당하는 경량 Agent입니다.
+
+## 역할
+
+- 단일 파일 수정/생성
+- 설정 파일 변경
+- 오타/간단한 버그 수정
+- 소규모 코드 추가/삭제
+
+## 사용 시점
+
+### 적합한 경우
+
+- 1-2개 파일만 수정하는 작업
+- 단순한 코드 변경 (변수명 변경, 설정값 수정 등)
+- 설정 파일 업데이트 (.env, config, yml 등)
+- 간단한 버그 수정
+
+### 부적합한 경우 (code-writer 사용)
+
+- 3개 이상 파일 수정
+- 새 기능 구현
+- 대규모 리팩토링
+- 복잡한 로직 변경
+
+## 작업 규칙
+
+1. 수정 전 반드시 대상 파일을 Read로 읽기
+2. Edit 또는 Write로 수정
+3. 수정 결과를 요약하여 반환
+
+## 출력 형식
+
+```
+# 수정 완료
+
+## 변경 파일
+- `path/to/file.ts` - 변경 내용 요약
+
+## 변경 내용
+- 수정 사항 설명
+```

package/.claude/hooks/skill-forced.sh

@@ -34,6 +34,7 @@ Main Agent의 Context Window는 제한적입니다.
 | 영향 분석 | impact-analyzer | 분석 결과만 받음 |
 | 코드 리뷰 | code-reviewer | 리뷰 결과만 받음 |
 | 테스트/빌드 검증 | qa-tester | 검증 결과만 받음 |
+| 간단한 코드 수정 (1-2파일) | simple-code-writer | 1-2개 파일도 Main이 직접 수정하지 않음 |
 | 여러 파일 코드 작성 | code-writer / designer | 구현 결과만 받음 |
 | Git 작업 | git-manager | 커밋/PR 결과만 받음 |
 
@@ -44,13 +45,14 @@ Main Agent의 Context Window는 제한적입니다.
 - Main Agent에서 복잡한 분석/계획 수행
 - Main Agent에서 3개 이상 파일 수정
 - **Main Agent에서 직접 Git 명령어 실행 (git add, commit, push 등)**
+- **Main Agent에서 직접 코드 수정 (Edit/Write로 코드 파일 수정 금지)**
 
 ### ✅ Main Agent 허용 작업 (이것만 직접 수행)
 
-- 단일~소수(1-2개) 파일 수정 (Edit)
-- 단일~소수(1-2개) 파일 생성 (Write)
-- 단순 명령 실행 (Bash) - **단, Git 명령어 제외**
 - 사용자와 대화/질문 응답
+- Task 흐름 관리 (TaskCreate, TaskUpdate, TaskList)
+- Subagent 호출 및 결과 전달
+- 단순 명령 실행 (Bash) - **단, Git/코드수정 명령어 제외**
 
 ### 🔒 Git 작업은 반드시 Subagent 사용 (필수)
 

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

@@ -36,10 +36,29 @@ estimated_tokens: ~100
 
 > 상세 형식 및 예시: `git.md`
 
+### PR 타이틀
+
+- PREFIX 없이 간결하게 작성
+- 예시: `결제 완료 후 주문 저장 구현`, `로그인 세션 만료 오류 수정`
+
+### PR 본문 구조
+
+| 섹션 | 설명 |
+|------|------|
+| 📋 Summary | 핵심 변경 1-2문장 요약 |
+| 🔄 주요 변경사항 | 파일별 변경 내용 |
+| ⚠️ 사이드 이펙트 | 다른 영역 영향 분석 |
+| 🔀 변경 흐름 | mermaid 다이어그램 (선택) |
+
 ### PR 워크플로우
 
-```
-변경사항 분석 → 영향 분석 → PR 작성 → Self Review → 팀원 리뷰 → Merge
+```mermaid
+graph LR
+  A[변경사항 분석] --> B[영향 분석]
+  B --> C[PR 작성]
+  C --> D[Self Review]
+  D --> E[팀원 리뷰]
+  E --> F[Merge]
 ```
 
 > 상세 Step: `git.md`

package/.claude/skills/Git/git.md

@@ -121,45 +121,37 @@ grep -r "import.*변경된함수명" --include="*.ts" --include="*.tsx"
 ### Step 4: PR 본문 작성
 
 ```markdown
-## Summary
+## 📋 Summary
 
-- **핵심 변경 1**: 설명
-- **핵심 변경 2**: 설명
+> 이 PR이 해결하는 문제와 접근 방식을 1-2문장으로 설명
 
-## 주요 변경사항
+## 🔄 주요 변경사항
 
-### Backend API (해당시)
-**엔드포인트명:**
-```typescript
-// Input
-{ field: type }
-// Output
-{ field: type }
-```
+### [변경 제목 1]
+**파일:** `path/to/file.ts`
+- 변경 내용 설명
 
-### Frontend (해당시)
-**컴포넌트/페이지:**
-- 주요 기능 1
-- 주요 기능 2
+### [변경 제목 2]
+**파일:** `path/to/file.ts`
+- 변경 내용 설명
 
-## 변경된 파일
-- `path/to/file1.ts` - 변경 내용
-- `path/to/file2.tsx` - 변경 내용
+## ⚠️ 사이드 이펙트
 
-## 영향 범위
+> 이 변경으로 인해 다른 부분에 발생할 수 있는 영향
 
-### Breaking Changes (해당시)
-- 변경된 API/타입과 영향받는 코드
+| 영향 받는 영역 | 영향 내용 | 위험도 |
+|---------------|----------|--------|
+| 없음 | - | - |
 
-### 사이드이펙트 검토
-- 영향받는 기능 없음 / 또는 영향 목록
+## 🔀 변경 흐름
 
-## 테스트 (해당시)
-- [ ] 단위 테스트
-- [ ] 통합 테스트
-- [ ] 수동 테스트
+```mermaid
+graph LR
+  A[변경 시작점] --> B[영향 받는 모듈]
+  B --> C[최종 결과]
+```
 
-Generated with [Claude Code](https://claude.com/claude-code)
+Generated with [Claude Code](https://claude.ai/code)
 ```
 
 ### Step 5: PR 생성
@@ -167,7 +159,7 @@ Generated with [Claude Code](https://claude.com/claude-code)
 ```bash
 git push -u origin feature/branch-name
 
-gh pr create --base main --title "TYPE: 제목" --body "$(cat <<'EOF'
+gh pr create --base main --title "<간결한 제목>" --body "$(cat <<'EOF'
 ## Summary
 ...
 EOF
@@ -301,18 +293,19 @@ gh pr comment <PR번호> --body "리뷰 피드백 반영 완료. 재확인 부
 
 ## 전체 PR 워크플로우 요약
 
-```
-┌─────────────────────────────────────────────────────────────┐
-│  1. 변경사항 분석 → 2. 영향 범위 분석 → 3. 영향 판단       │
-│                          ↓                                   │
-│  4. PR 본문 작성 → 5. PR 생성 (gh pr create)                │
-│                          ↓                                   │
-│  6. Self PR Review → 이슈 발견 시 수정 → push               │
-│                          ↓                                   │
-│  7. 팀원 리뷰 대기 → 피드백 있으면 PR Apply Mode            │
-│                          ↓                                   │
-│  8. Approve → Merge                                          │
-└─────────────────────────────────────────────────────────────┘
+```mermaid
+graph TD
+  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]
+  I --> H
+  H -->|Approve| J[✅ Merge]
 ```
 
 ### 관련 Skill 참조

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jun-claude-code",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Claude Code configuration template - copy .claude settings to your project",
   "main": "dist/index.js",
   "bin": "dist/cli.js",