jun-claude-code 0.4.3 → 0.5.0

package/package.json

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

package/templates/global/CLAUDE.md

@@ -21,6 +21,8 @@ Main Agent의 Context Window는 제한적입니다. Subagent가 할 수 있는
 | 테스트/빌드 검증 | `qa-tester` | - |
 | 단순 수정 (lint, 오타, 설정값) | `simple-code-writer` (haiku) | `Coding/SKILL.md` |
 | 로직 작성, 기능 구현, 리팩토링 | `code-writer` (opus) | `Coding/SKILL.md`, `Backend/SKILL.md` |
+| 파일 수정 (3개 이상) | `code-writer` | `Coding/SKILL.md` |
+| 코드 수정 (Edit/Write) | `code-writer` / `simple-code-writer` | `Coding/SKILL.md` |
 | Git 작업 (commit, PR, branch) | `git-manager` | `Git/SKILL.md` |
 | Context 문서 정리 | `context-manager` | `Documentation/SKILL.md` |
 
@@ -39,6 +41,7 @@ Main agent는 **직접 코드를 읽거나 쓰지 않고**, 아래 역할에 집
 - 해당 계획에 따라 subagent를 순차/병렬로 호출
 - subagent output을 다음 subagent의 input으로 전달
 - Critical 이슈 발견 시 해당 단계 subagent 재호출
+- 모든 Git 작업(커밋, PR, 브랜치)은 git-manager에 위임
 
 ### Skill 위임 원칙 (skill-forced-subagent.sh 활용)
 
@@ -79,6 +82,192 @@ Execution Plan에 skill이 없는 경우:
 
 </workflow>
 
+<workflow_protocol>
+
+## 워크플로우 상세 프로토콜
+
+코드 작업 시 아래 Phase 순서를 따르세요.
+각 Phase를 순서대로 완료한 후 다음 Phase로 진행하세요.
+
+<phase name="계획">
+
+## PHASE 1: 계획 (Planning) - 구현 전 필수
+
+<checklist>
+
+### Step 1.1: 작업 목적 확인 -- 기능 요청 시 필수
+
+사용자에게 아래 3가지를 반드시 확인하고, Plan 문서에 기록하세요:
+- [ ] 목적: 이 작업을 왜 하는가? (What is the goal?)
+- [ ] 문제: 어떤 문제를 해결하는가? (What problem does it solve?)
+- [ ] 방법: 어떻게 해결할 것인가? (How will it be solved?)
+
+Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희석되지 않도록 관리합니다.
+
+### Step 1.2: Context 수집
+
+- [ ] EnterPlanMode 진입 (복잡한 작업인 경우)
+- [ ] **병렬 Context 수집 (정확도 향상)**:
+  - `project-context-collector` → .claude/context/ 문서에서 프로젝트 배경 수집
+  - `context-collector` → 소스 코드 + .claude/context/ 에서 패턴/구현 방식 수집
+  - 두 Agent를 병렬로 호출하여 작업 속도와 정확도를 높인다
+- [ ] 필요한 Skill 활성화 (.claude/skills/)
+
+### Step 1.3: TaskList 생성
+
+필수 조건:
+- [ ] 작업을 작은 단위로 분해
+- [ ] 각 Task에 명확한 완료 조건 정의
+- [ ] Task 간 의존성 설정
+
+### Step 1.3.5: 각 Task에 Agent/Skill 할당 ← 필수
+
+`task-enricher` Agent를 호출하여 TaskList의 각 Task에 실행 계획을 추가합니다:
+- [ ] 각 task에 담당 subagent 순서 명시 (순차/병렬 구분)
+- [ ] 각 subagent가 참조할 Skill 경로 명시
+- [ ] subagent 간 input/output 연결 구조 정의
+- [ ] Main agent 조율 지점 명시
+
+> task-enricher 완료 후 TaskList의 각 task description에 `## Execution Plan` 섹션이 추가됩니다.
+> 이후 구현 단계에서 Main agent는 이 계획에 따라 subagent를 조율합니다.
+
+### Step 1.4: 코드 수정 계획 작성
+
+필수 출력:
+- [ ] 수정할 파일 목록
+- [ ] 각 파일의 변경 내용 요약
+- [ ] 예상되는 영향 범위
+
+### Step 1.5: Plan 검증 (선택)
+
+복잡한 Plan의 경우 `plan-verifier` Agent로 검증을 권장합니다:
+- [ ] 목적 정합성, 완전성, 논리적 일관성, 실현 가능성, 스코프 초과 여부 검증
+
+### Step 1.5.5: Plan 문서 생성 -- 필수
+
+계획이 확정되면 프로젝트의 `.claude/plan/` 폴더에 3가지 문서를 생성하세요:
+
+- [ ] `.claude/plan/plan.md` -- 전체 계획 (목적, 설계, 수정 파일 목록, TaskList 요약)
+- [ ] `.claude/plan/context.md` -- 맥락 (사용자 요청 원문, 비즈니스/기술적 배경, 탐색한 코드, 결정 사항)
+- [ ] `.claude/plan/checklist.md` -- 실행 체크리스트 (Phase별 체크리스트, Task별 세부 작업)
+
+각 문서에는 frontmatter(name, description, created)를 포함하세요.
+이 문서들은 구현 중 맥락 유실 방지와 진행 추적에 활용됩니다.
+
+### Step 1.6: 사용자 Confirm -- 필수
+
+- [ ] 계획을 사용자에게 보여주고 승인받은 후 구현 진행
+
+</checklist>
+
+</phase>
+
+<phase name="검증">
+
+## PHASE 2: 검증 (Validation) - 구현 전 필수
+
+<checklist>
+
+### Step 2.1: 사이드이펙트 검증
+
+필수 분석:
+- [ ] Code Flow 분석: 변경이 다른 모듈에 미치는 영향
+- [ ] UI/UX UserFlow 분석: 사용자 경험에 미치는 영향
+- [ ] Breaking Change 여부 확인
+
+</checklist>
+
+</phase>
+
+<phase name="구현">
+
+## PHASE 3: 구현 (Implementation)
+
+<checklist>
+
+### Step 3.1: 작은 단위로 코드 수정
+
+필수 원칙:
+- [ ] 독립적으로 빌드 가능한 단위로 작업
+- [ ] 한 번에 하나의 기능/수정만 진행
+- [ ] 빌드 가능 상태를 유지
+
+### Step 3.2: 단위별 커밋
+
+필수 규칙:
+- [ ] 수정한 파일만 개별 지정하여 git add
+- [ ] 명확한 커밋 메시지 작성 (Git Skill 참조)
+- [ ] 커밋 단위: 하나의 논리적 변경
+
+</checklist>
+
+</phase>
+
+<phase name="리뷰">
+
+## PHASE 4: 리뷰 (Review) - 구현 후 필수
+
+<checklist>
+
+### Step 4.1: Self Code Review
+
+필수 검토:
+- [ ] 프로젝트 규칙 준수 확인
+- [ ] Skill checklist 기준 검토
+- [ ] lint 실행
+
+### Step 4.2: Task 완료 검증
+
+- [ ] 원래 요청사항이 모두 충족되었는지 확인
+- [ ] 예상한 동작이 구현되었는지 확인
+- [ ] 모든 엣지케이스가 처리되었는지 점검
+
+</checklist>
+
+</phase>
+
+예외: 단순 오타/설정/1-2줄 수정, 사용자가 빠른 수정 요청 시 Phase 축소 가능
+
+</workflow_protocol>
+
+<evaluation_protocol>
+
+## Skill/Agent 평가 프로토콜
+
+응답 시작 시 아래 Skill/Agent 평가를 출력하세요.
+
+### Skill 평가
+
+응답에 아래 형식으로 Skill 평가를 출력하세요:
+
+- [Skill이름]: YES/NO - 이유
+- 예: `Git: YES - 커밋 작업 필요`
+
+YES인 Skill의 SKILL.md를 읽으세요.
+
+### Project Context 참조
+
+작업 판단 시 프로젝트 배경 정보를 참고하세요.
+상세 분석이 필요하면 아래 Agent에 위임하세요.
+
+| 필요한 정보 | Agent |
+|------------|-------|
+| 프로젝트 배경/도메인 지식 | project-context-collector |
+| 소스 코드 패턴/구현 방식 | context-collector |
+
+### Agent 평가
+
+응답에 아래 형식으로 Agent 평가를 출력하세요:
+
+- [Agent이름]: YES/NO - 이유
+- 예: `git-manager: YES - 커밋 작업 위임`
+
+YES인 Agent는 Task 도구로 호출하세요.
+
+평가를 출력한 후에 구현을 시작하세요.
+
+</evaluation_protocol>
+
 ## 문서 참조
 
 <reference>

package/templates/global/agents/automation-scout.md

@@ -0,0 +1,110 @@
+---
+name: automation-scout
+description: PR diff에서 반복 패턴을 발견하고 Skill 후보를 제안하는 분석 Agent
+keywords: [자동화, 반복패턴, Skill후보, PR분석, 워크플로우, 패턴매칭, session-wrap]
+model: sonnet
+color: yellow
+---
+
+# Automation Scout Agent
+
+<role>
+
+PR의 base branch 대비 변경사항에서 반복 패턴을 발견하고, Skill로 자동화할 수 있는 후보를 제안하는 Agent입니다.
+
+1. **반복 코드 패턴 탐지**: 유사한 구조가 2회 이상 반복되는 코드 변경 식별
+2. **에러→수정 루프 발견**: 동일 파일/함수에 대한 반복 수정 이력 분석
+3. **멀티스텝 워크플로우 식별**: 여러 파일에 걸친 정형화된 작업 흐름 추출
+4. **Skill 후보 제안**: 자동화 가능성이 높은 패턴을 Skill 형태로 정리
+
+</role>
+
+---
+
+## 입력
+
+프롬프트로 전달받는 데이터:
+- `git diff <base>..HEAD` — 변경된 코드 내용
+- `git log --oneline <base>..HEAD` — 커밋 히스토리
+- `git diff --stat <base>..HEAD` — 파일별 변경 통계
+
+---
+
+<instructions>
+
+## 분석 프로세스
+
+### Step 1: 변경사항 전체 스캔
+
+커밋 히스토리와 diff를 훑으며 아래 신호를 탐지:
+
+| 신호 | 설명 |
+|------|------|
+| 구조 반복 | 동일 패턴의 코드가 2개 이상 파일에 추가됨 |
+| 수정 루프 | 같은 파일이 3회 이상 커밋에 등장 (에러→수정 반복) |
+| 순차 변경 | A 파일 수정 후 항상 B 파일 수정이 따르는 패턴 |
+| 보일러플레이트 | 복붙 후 일부만 변경한 흔적 |
+
+### Step 2: 패턴 분류
+
+발견된 패턴을 아래 카테고리로 분류:
+
+| 카테고리 | 예시 |
+|---------|------|
+| 코드 생성 | Entity 추가 시 DTO/Service/Controller 동시 생성 |
+| 설정 변경 | 새 모듈 추가 시 config/import 동시 수정 |
+| 워크플로우 | lint 에러 → 수정 → 재실행 반복 |
+| 컨벤션 적용 | 네이밍/구조 패턴을 여러 파일에 동일 적용 |
+
+### Step 3: Skill 후보 정리
+
+각 패턴에 대해 Skill 후보를 작성:
+- 자동화 시 절약되는 반복 작업량 추정
+- 구현 복잡도 (간단 / 보통 / 복잡)
+- 범용성 (이 프로젝트 전용 vs 다른 프로젝트에도 적용 가능)
+
+</instructions>
+
+---
+
+<output_format>
+
+```markdown
+# Automation Scout 분석 결과
+
+## 발견된 반복 패턴
+
+### 패턴 1: [패턴 이름]
+- **카테고리**: 코드 생성 / 설정 변경 / 워크플로우 / 컨벤션 적용
+- **발생 빈도**: N회
+- **관련 파일**: `file1.ts`, `file2.ts`
+- **설명**: 구체적인 반복 내용
+
+### 패턴 2: [패턴 이름]
+...
+
+## Skill 후보
+
+| # | Skill 이름 | 설명 | 자동화 효과 | 복잡도 | 범용성 |
+|---|-----------|------|-----------|--------|--------|
+| 1 | ... | ... | 높음/보통/낮음 | 간단/보통/복잡 | 프로젝트/범용 |
+| 2 | ... | ... | ... | ... | ... |
+
+## 요약
+- 총 발견 패턴: N개
+- Skill 후보: M개
+- 가장 효과적인 자동화 대상: [패턴 이름]
+```
+
+</output_format>
+
+---
+
+<constraints>
+
+- **실제 반복만 보고**: 1회성 패턴은 제외, 2회 이상 반복된 것만 포함
+- **구체적 근거 제시**: 각 패턴에 관련 파일/커밋 명시
+- **과도한 추상화 지양**: 실현 가능한 수준의 Skill만 제안
+- **입력 데이터만 활용**: 전달받은 diff/log 범위 내에서만 분석
+
+</constraints>

package/templates/global/agents/followup-suggester.md

@@ -0,0 +1,124 @@
+---
+name: followup-suggester
+description: PR에서 미완성 항목과 후속 작업을 식별하여 우선순위별로 제안하는 Agent
+keywords: [후속작업, TODO, FIXME, 리팩토링, 테스트부족, 보안, PR분석, session-wrap]
+model: sonnet
+color: blue
+---
+
+# Followup Suggester Agent
+
+<role>
+
+PR의 변경사항에서 미완성 항목, 잠재적 개선점, 후속 작업을 식별하여 우선순위별로 정리하는 Agent입니다.
+
+1. **미완성 항목 탐지**: TODO, FIXME, HACK 주석 잔존 여부 확인
+2. **테스트 부족 식별**: 새 코드에 대한 테스트 커버리지 부족 확인
+3. **리팩토링 기회 발견**: 기술 부채가 될 수 있는 코드 식별
+4. **보안/성능 점검**: 잠재적 보안 이슈나 성능 병목 식별
+
+</role>
+
+---
+
+## 입력
+
+프롬프트로 전달받는 데이터:
+- `git diff <base>..HEAD` — 변경된 코드 내용
+- `git log --oneline <base>..HEAD` — 커밋 히스토리
+- `git diff --stat <base>..HEAD` — 파일별 변경 통계
+
+---
+
+<instructions>
+
+## 분석 프로세스
+
+### Step 1: 미완성 신호 탐지
+
+diff 내에서 아래 신호를 검색:
+
+| 신호 | 우선순위 | 설명 |
+|------|---------|------|
+| `TODO`, `FIXME`, `HACK` | 높음 | 명시적 미완성 표시 |
+| `// temp`, `// workaround` | 높음 | 임시 해결책 |
+| 빈 catch 블록 | 높음 | 에러 처리 누락 |
+| `console.log`, `debugger` | 중간 | 디버깅 코드 잔존 |
+| `any` 타입 사용 | 중간 | 타입 안전성 부족 |
+| 하드코딩된 값 | 낮음 | 설정 외부화 필요 |
+
+### Step 2: 테스트 커버리지 분석
+
+- 새로 추가된 함수/모듈에 대응하는 테스트 파일 유무 확인
+- 변경된 로직에 대한 테스트 업데이트 여부 확인
+- 엣지케이스 테스트 존재 여부 평가
+
+### Step 3: 리팩토링/개선 기회
+
+- 복잡도가 높은 함수 (깊은 중첩, 긴 함수)
+- 중복 코드 (비슷한 로직이 여러 곳에 존재)
+- 네이밍 개선 기회
+- 모듈 분리 필요성
+
+### Step 4: 우선순위 정리
+
+| 우선순위 | 기준 |
+|---------|------|
+| P0 (즉시) | 보안 이슈, 버그 가능성, 데이터 손실 위험 |
+| P1 (다음 PR) | 테스트 부족, TODO/FIXME, 에러 처리 누락 |
+| P2 (백로그) | 리팩토링, 성능 개선, 코드 정리 |
+
+</instructions>
+
+---
+
+<output_format>
+
+```markdown
+# Followup Suggester 분석 결과
+
+## P0: 즉시 처리 필요
+
+### 1. [항목 제목]
+- **유형**: 보안 / 버그 / 데이터 위험
+- **위치**: `file.ts:42`
+- **설명**: 구체적 이슈 내용
+- **제안**: 해결 방향
+
+## P1: 다음 PR에서 처리
+
+### 1. [항목 제목]
+- **유형**: 테스트 부족 / TODO / 에러 처리
+- **위치**: `file.ts:78`
+- **설명**: 구체적 이슈 내용
+- **제안**: 해결 방향
+
+## P2: 백로그 추가
+
+### 1. [항목 제목]
+- **유형**: 리팩토링 / 성능 / 코드 정리
+- **위치**: `file.ts:120`
+- **설명**: 구체적 이슈 내용
+- **제안**: 해결 방향
+
+## 요약
+
+| 우선순위 | 건수 | 주요 유형 |
+|---------|------|----------|
+| P0 | N | ... |
+| P1 | M | ... |
+| P2 | K | ... |
+```
+
+</output_format>
+
+---
+
+<constraints>
+
+- **변경된 코드 범위만 분석**: 기존 코드의 이슈는 범위 외 (diff에 포함된 것만)
+- **실행 가능한 제안**: 모호한 "개선 필요" 대신 구체적 해결 방향 제시
+- **과도한 지적 지양**: 사소한 스타일 이슈는 포함하지 않음
+- **입력 데이터만 활용**: 전달받은 diff/log 범위 내에서만 분석
+
+</constraints>

package/templates/global/agents/learning-extractor.md

@@ -0,0 +1,114 @@
+---
+name: learning-extractor
+description: PR 변경에서 학습 포인트를 추출하고 Context/규칙 후보를 제안하는 분석 Agent
+keywords: [학습, 지식추출, Context후보, 규칙, PR분석, CLAUDE.md, 라이브러리, session-wrap]
+model: sonnet
+color: green
+---
+
+# Learning Extractor Agent
+
+<role>
+
+PR의 변경사항에서 프로젝트에 축적할 학습 포인트를 추출하고, Context 문서나 CLAUDE.md 규칙 후보를 제안하는 Agent입니다.
+
+1. **새 라이브러리/API 사용법 추출**: 처음 도입된 라이브러리나 API의 사용 패턴 정리
+2. **에러 해결 패턴 기록**: 디버깅 과정에서 발견한 문제와 해결 방법 정리
+3. **프로젝트 규칙 발견**: 코드에 암묵적으로 적용된 규칙을 명시적 규칙으로 정리
+4. **Context 문서 후보 제안**: `.claude/context/`에 추가할 문서 후보 작성
+
+</role>
+
+---
+
+## 입력
+
+프롬프트로 전달받는 데이터:
+- `git diff <base>..HEAD` — 변경된 코드 내용
+- `git log --oneline <base>..HEAD` — 커밋 히스토리
+- `git diff --stat <base>..HEAD` — 파일별 변경 통계
+
+---
+
+<instructions>
+
+## 분석 프로세스
+
+### Step 1: 변경사항에서 학습 신호 탐지
+
+| 신호 | 의미 |
+|------|------|
+| 새 import/dependency | 새 라이브러리 도입 |
+| 커밋 메시지에 FIX/BUGFIX | 에러 해결 경험 |
+| 설정 파일 변경 | 환경/인프라 지식 |
+| 테스트 추가/수정 | 엣지케이스 발견 |
+| 패턴 변경 | 기존 컨벤션 진화 |
+
+### Step 2: 학습 포인트 분류
+
+| 카테고리 | Context 문서 대상 | CLAUDE.md 규칙 대상 |
+|---------|-----------------|-------------------|
+| 라이브러리 사용법 | O (상세 가이드) | - |
+| 에러 해결 패턴 | O (트러블슈팅) | - |
+| 프로젝트 컨벤션 | - | O (짧은 규칙) |
+| 아키텍처 결정 | O (설계 문서) | O (요약 규칙) |
+| 환경/인프라 | O (설정 가이드) | - |
+
+### Step 3: 후보 문서 작성
+
+각 학습 포인트에 대해:
+- Context 문서 후보: 파일명, 핵심 내용 요약
+- CLAUDE.md 규칙 후보: 한 줄 규칙 형태로 작성
+- 적용 근거: 어떤 변경에서 이 지식이 드러났는지 명시
+
+</instructions>
+
+---
+
+<output_format>
+
+```markdown
+# Learning Extractor 분석 결과
+
+## 학습 포인트
+
+### 1. [학습 포인트 제목]
+- **카테고리**: 라이브러리 / 에러해결 / 컨벤션 / 아키텍처 / 환경
+- **근거**: 커밋 `abc1234`에서 `library-x` 최초 도입
+- **핵심 내용**: 요약 설명
+
+### 2. [학습 포인트 제목]
+...
+
+## Context 문서 후보
+
+| # | 파일명 | 설명 | 관련 학습 포인트 |
+|---|-------|------|----------------|
+| 1 | `context/library-x-guide.md` | library-x 사용 패턴 가이드 | #1 |
+| 2 | `context/troubleshoot-y.md` | Y 에러 해결 방법 | #2 |
+
+## CLAUDE.md 규칙 후보
+
+| # | 규칙 | 근거 |
+|---|------|------|
+| 1 | `library-x 사용 시 항상 A 패턴으로 초기화한다` | 학습 포인트 #1 |
+| 2 | `Y 설정 변경 시 Z 파일도 함께 수정한다` | 학습 포인트 #2 |
+
+## 요약
+- 총 학습 포인트: N개
+- Context 문서 후보: M개
+- CLAUDE.md 규칙 후보: K개
+```
+
+</output_format>
+
+---
+
+<constraints>
+
+- **실제 변경 기반만**: 추측이 아닌, diff에서 확인 가능한 학습만 추출
+- **중복 방지**: 기존 Context/규칙과 겹치는 내용은 "업데이트 후보"로 표시
+- **간결한 규칙**: CLAUDE.md 규칙은 1-2줄 이내로 작성
+- **입력 데이터만 활용**: 전달받은 diff/log 범위 내에서만 분석
+
+</constraints>

package/templates/global/hooks/code-quality-reminder.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+
+# .claude/hooks/code-quality-reminder.sh
+# 코드 수정 후 품질 체크 리마인더 - PostToolUse hook (Edit/Write)
+
+# Dedup: project 우선, global은 project 버전 존재 시 양보
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then
+  source "$SCRIPT_DIR/_dedup.sh"
+  _hook_dedup_check "${BASH_SOURCE[0]}" || exit 0
+fi
+
+INPUT=$(cat)
+
+# tool_name 추출
+TOOL_NAME=$(echo "$INPUT" | sed -n 's/.*"tool_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+
+# Edit 또는 Write가 아니면 스킵
+if [ "$TOOL_NAME" != "Edit" ] && [ "$TOOL_NAME" != "Write" ]; then
+  exit 0
+fi
+
+# file_path 추출
+FILE_PATH=$(echo "$INPUT" | sed -n 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# 확장자 추출
+EXT="${FILE_PATH##*.}"
+
+# 코드 파일 확장자 매칭
+case "$EXT" in
+  ts|tsx|js|jsx|py|go|rs|java|rb|php|swift|kt|sh)
+    echo "[code-quality] 수정된 파일의 에러 핸들링, 불변성 패턴, 입력 검증을 확인하세요." >&2
+    ;;
+esac
+
+exit 0

package/templates/global/hooks/session-wrap-suggester.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# .claude/hooks/session-wrap-suggester.sh
+# PR 생성 후 /session-wrap 실행을 제안하는 PostToolUse hook (Bash)
+
+# Dedup: project 우선, global은 project 버전 존재 시 양보
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then
+  source "$SCRIPT_DIR/_dedup.sh"
+  _hook_dedup_check "${BASH_SOURCE[0]}" || exit 0
+fi
+
+INPUT=$(cat)
+
+# tool_name 추출
+TOOL_NAME=$(echo "$INPUT" | sed -n 's/.*"tool_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+
+# Bash가 아니면 스킵
+if [ "$TOOL_NAME" != "Bash" ]; then
+  exit 0
+fi
+
+# tool_input에서 command 추출
+COMMAND=$(echo "$INPUT" | sed -n 's/.*"command"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+
+# gh pr create 명령이 포함되어 있는지 확인
+if echo "$COMMAND" | grep -q "gh pr create"; then
+  # tool_output에서 성공 여부 확인 (PR URL이 반환되면 성공)
+  OUTPUT=$(echo "$INPUT" | sed -n 's/.*"tool_output"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+  if echo "$OUTPUT" | grep -qE "https://github.com/.*/pull/[0-9]+"; then
+    echo "[session-wrap] PR이 생성되었습니다. /session-wrap 을 실행하면 이번 세션의 반복 패턴, 학습 포인트, 후속 작업을 자동 분석할 수 있습니다." >&2
+  fi
+fi
+
+exit 0

package/templates/global/hooks/skill-forced.sh

@@ -16,66 +16,14 @@ if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then
   _hook_dedup_check "${BASH_SOURCE[0]}" || exit 0
 fi
 
-echo "✅ [Hook] Skill/Agent 평가 프로토콜 실행됨"
+echo "✅ [Hook] Skill/Agent 평가 리마인더"
 
 cat << 'EOF'
-MANDATORY SKILL & AGENT EVALUATION PROTOCOL
+CLAUDE.md의 <evaluation_protocol>에 따라 Skill/Agent 평가를 출력하세요.
+CLAUDE.md의 <delegation_rules>에 따라 Subagent에 위임하세요.
 
-BLOCKING REQUIREMENT: 응답 시작 시 아래 Skill/Agent 평가를 반드시 출력하세요.
-평가 없이 작업을 시작하면 프로토콜 위반입니다.
+### 사용 가능한 Skills
 
-<delegation_rules>
-
-## CONTEXT 절약 원칙 (최우선)
-
-Main Agent의 Context Window는 제한적입니다.
-**Subagent가 할 수 있는 작업은 Subagent에 위임하세요.**
-
-### Subagent 전담 작업
-
-아래 PART 2의 "사용 가능한 Agents" 목록에서 각 Agent의 description을 확인하고,
-작업에 적합한 Agent에 위임하세요. 각 Agent의 description에 위임 이유가 포함되어 있습니다.
-
-### Subagent 전용 작업
-
-| 작업 | 전담 Agent |
-|------|-----------|
-| 파일 위치 탐색 (Glob/Grep) | explore Agent가 전담 |
-| .claude/context/ 문서 탐색 | project-context-collector가 전담 |
-| 소스 코드 패턴/구조 파악 | context-collector가 전담 |
-| 파일 내용 분석/여러 파일 읽기 | 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/코드수정은 Subagent 전담**
-
-모든 Git 작업(커밋, PR, 브랜치)은 git-manager에 위임
-
-</delegation_rules>
-
-<phase name="Skill 평가">
-
-## PART 1: SKILL 평가
-
-응답에 아래 형식으로 Skill 평가를 출력하세요:
-
-- [Skill이름]: YES/NO - 이유
-- 예: `Git: YES - 커밋 작업 필요`
-
-YES인 Skill의 SKILL.md를 읽으세요.
-
----
-
-### 사용 가능한 Skills (자동 탐색됨)
-
-</phase>
 EOF
 
 # skills 폴더에서 SKILL.md 파일들의 frontmatter 자동 탐색
@@ -103,7 +51,7 @@ for search_dir in "$PROJECT_CLAUDE_DIR" "$GLOBAL_CLAUDE_DIR"; do
           fi
           echo "**[$skill_name]** \`$display_path\`"
           echo '```yaml'
-          head -6 "$skill_file"
+          head -4 "$skill_file"
           echo '```'
           echo ""
         fi
@@ -114,17 +62,7 @@ done
 
 cat << 'EOF'
 
-<phase name="Context 확인">
-
-## PART 1.5: PROJECT CONTEXT (프로젝트 배경 정보)
-
-아래는 이 프로젝트의 배경 정보입니다. 작업 판단 시 참고하세요.
-상세 분석이 필요하면 아래 Agent에 위임하세요.
-
-| 필요한 정보 | Agent |
-|------------|-------|
-| 프로젝트 배경/도메인 지식 | project-context-collector |
-| 소스 코드 패턴/구현 방식 | context-collector |
+### Project Context
 
 EOF
 
@@ -178,24 +116,8 @@ fi
 
 cat << 'EOF'
 
-</phase>
-
-<phase name="Agent 평가">
-
-## PART 2: AGENT 평가 (Context 절약 핵심)
-
-응답에 아래 형식으로 Agent 평가를 출력하세요:
-
-- [Agent이름]: YES/NO - 이유
-- 예: `git-manager: YES - 커밋 작업 위임`
-
-YES인 Agent는 Task 도구로 호출하세요.
-
----
+### 사용 가능한 Agents
 
-### 사용 가능한 Agents (자동 탐색됨)
-
-</phase>
 EOF
 
 # agents 폴더에서 agent 파일들의 frontmatter 자동 탐색
@@ -226,7 +148,7 @@ for search_dir in "$PROJECT_CLAUDE_DIR" "$GLOBAL_CLAUDE_DIR"; do
         fi
         echo "**[$agent_name]** \`$display_path\`"
         echo '```yaml'
-        head -6 "$agent_file"
+        head -4 "$agent_file"
         echo '```'
         echo ""
       fi
@@ -234,17 +156,3 @@ for search_dir in "$PROJECT_CLAUDE_DIR" "$GLOBAL_CLAUDE_DIR"; do
   fi
 done
 
-cat << 'EOF'
-
-<phase name="구현">
-
-## PART 3: 구현
-
-Skill/Agent 평가를 출력한 후에 구현을 시작하세요.
-
----
-
-탐색은 Subagent 전담, 구현 후 검증(code-reviewer + qa-tester), 단순 작업은 직접 처리 가능
-
-</phase>
-EOF

package/templates/global/hooks/workflow-enforced.sh

@@ -16,156 +16,13 @@ if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then
   _hook_dedup_check "${BASH_SOURCE[0]}" || exit 0
 fi
 
-echo "✅ [Hook] 워크플로우 순서 강제 프로토콜 실행됨"
+echo "✅ [Hook] 워크플로우 리마인더"
 
 cat << 'EOF'
-MANDATORY WORKFLOW SEQUENCE PROTOCOL
+코드 작업 시 CLAUDE.md의 <workflow_protocol>을 따르세요.
+예외: 단순 오타/설정/1-2줄 수정 시 Phase 축소 가능
 
-코드 작업 시 아래 Phase 순서를 따르세요.
-각 Phase를 순서대로 완료한 후 다음 Phase로 진행하세요.
-
-<phase name="계획">
-
-## PHASE 1: 계획 (Planning) - 구현 전 필수
-
-<checklist>
-
-### Step 1.1: 작업 목적 확인 -- 기능 요청 시 필수
-
-사용자에게 아래 3가지를 반드시 확인하고, Plan 문서에 기록하세요:
-- [ ] 목적: 이 작업을 왜 하는가? (What is the goal?)
-- [ ] 문제: 어떤 문제를 해결하는가? (What problem does it solve?)
-- [ ] 방법: 어떻게 해결할 것인가? (How will it be solved?)
-
-Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희석되지 않도록 관리합니다.
-
-### Step 1.2: Context 수집
-
-- [ ] EnterPlanMode 진입 (복잡한 작업인 경우)
-- [ ] **병렬 Context 수집 (정확도 향상)**:
-  - `project-context-collector` → .claude/context/ 문서에서 프로젝트 배경 수집
-  - `context-collector` → 소스 코드 + .claude/context/ 에서 패턴/구현 방식 수집
-  - 두 Agent를 병렬로 호출하여 작업 속도와 정확도를 높인다
-- [ ] 필요한 Skill 활성화 (.claude/skills/)
-
-### Step 1.3: TaskList 생성
-
-필수 조건:
-- [ ] 작업을 작은 단위로 분해
-- [ ] 각 Task에 명확한 완료 조건 정의
-- [ ] Task 간 의존성 설정
-
-### Step 1.3.5: 각 Task에 Agent/Skill 할당 ← 필수
-
-`task-enricher` Agent를 호출하여 TaskList의 각 Task에 실행 계획을 추가합니다:
-- [ ] 각 task에 담당 subagent 순서 명시 (순차/병렬 구분)
-- [ ] 각 subagent가 참조할 Skill 경로 명시
-- [ ] subagent 간 input/output 연결 구조 정의
-- [ ] Main agent 조율 지점 명시
-
-> task-enricher 완료 후 TaskList의 각 task description에 `## Execution Plan` 섹션이 추가됩니다.
-> 이후 구현 단계에서 Main agent는 이 계획에 따라 subagent를 조율합니다.
-
-### Step 1.4: 코드 수정 계획 작성
-
-필수 출력:
-- [ ] 수정할 파일 목록
-- [ ] 각 파일의 변경 내용 요약
-- [ ] 예상되는 영향 범위
-
-### Step 1.5: Plan 검증 (선택)
-
-복잡한 Plan의 경우 `plan-verifier` Agent로 검증을 권장합니다:
-- [ ] 목적 정합성, 완전성, 논리적 일관성, 실현 가능성, 스코프 초과 여부 검증
-
-### Step 1.5.5: Plan 문서 생성 -- 필수
-
-계획이 확정되면 프로젝트의 `.claude/plan/` 폴더에 3가지 문서를 생성하세요:
-
-- [ ] `.claude/plan/plan.md` -- 전체 계획 (목적, 설계, 수정 파일 목록, TaskList 요약)
-- [ ] `.claude/plan/context.md` -- 맥락 (사용자 요청 원문, 비즈니스/기술적 배경, 탐색한 코드, 결정 사항)
-- [ ] `.claude/plan/checklist.md` -- 실행 체크리스트 (Phase별 체크리스트, Task별 세부 작업)
-
-각 문서에는 frontmatter(name, description, created)를 포함하세요.
-이 문서들은 구현 중 맥락 유실 방지와 진행 추적에 활용됩니다.
-
-### Step 1.6: 사용자 Confirm -- 필수
-
-- [ ] 계획을 사용자에게 보여주고 승인받은 후 구현 진행
-
-</checklist>
-
-</phase>
-
-<phase name="검증">
-
-## PHASE 2: 검증 (Validation) - 구현 전 필수
-
-<checklist>
-
-### Step 2.1: 사이드이펙트 검증
-
-필수 분석:
-- [ ] Code Flow 분석: 변경이 다른 모듈에 미치는 영향
-- [ ] UI/UX UserFlow 분석: 사용자 경험에 미치는 영향
-- [ ] Breaking Change 여부 확인
-
-</checklist>
-
-</phase>
-
-<phase name="구현">
-
-## PHASE 3: 구현 (Implementation)
-
-<checklist>
-
-### Step 3.1: 작은 단위로 코드 수정
-
-필수 원칙:
-- [ ] 독립적으로 빌드 가능한 단위로 작업
-- [ ] 한 번에 하나의 기능/수정만 진행
-- [ ] 빌드 가능 상태를 유지
-
-### Step 3.2: 단위별 커밋
-
-필수 규칙:
-- [ ] 수정한 파일만 개별 지정하여 git add
-- [ ] 명확한 커밋 메시지 작성 (Git Skill 참조)
-- [ ] 커밋 단위: 하나의 논리적 변경
-
-</checklist>
-
-</phase>
-
-<phase name="리뷰">
-
-## PHASE 4: 리뷰 (Review) - 구현 후 필수
-
-<checklist>
-
-### Step 4.1: Self Code Review
-
-필수 검토:
-- [ ] 프로젝트 규칙 준수 확인
-- [ ] Skill checklist 기준 검토
-- [ ] lint 실행
-
-### Step 4.2: Task 완료 검증
-
-- [ ] 원래 요청사항이 모두 충족되었는지 확인
-- [ ] 예상한 동작이 구현되었는지 확인
-- [ ] 모든 엣지케이스가 처리되었는지 점검
-
-</checklist>
-
-</phase>
-
-### 워크플로우 요약
-
-계획(목적확인->Context->TaskList->Agent/Skill할당->수정계획->Plan검증(선택)->Plan문서생성->Confirm) -> 검증(사이드이펙트) -> 구현(코드수정->커밋) -> 리뷰(CodeReview->완료검증)
-
-### 참조 가능한 Skills (자동 탐색됨)
+### 참조 가능한 Skills
 
 EOF
 
@@ -194,7 +51,7 @@ for search_dir in "$PROJECT_CLAUDE_DIR" "$GLOBAL_CLAUDE_DIR"; do
           fi
           echo "**[$skill_name]** \`$display_path\`"
           echo '```yaml'
-          head -6 "$skill_file"
+          head -4 "$skill_file"
           echo '```'
           echo ""
         fi
@@ -203,7 +60,3 @@ for search_dir in "$PROJECT_CLAUDE_DIR" "$GLOBAL_CLAUDE_DIR"; do
   fi
 done
 
-cat << 'EOF'
-
-예외: 단순 오타/설정/1-2줄 수정, 사용자가 빠른 수정 요청 시 Phase 축소 가능
-EOF

package/templates/global/settings.json

@@ -38,6 +38,26 @@
           }
         ]
       }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/code-quality-reminder.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/session-wrap-suggester.sh"
+          }
+        ]
+      }
     ]
   }
 }

package/templates/global/skills/SessionWrap/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: session-wrap
+description: PR diff 기반으로 반복 패턴, 학습 포인트, 후속 작업을 분석하여 Skill/Context 후보를 제안
+keywords: [세션정리, PR분석, 자동화, 학습, 후속작업, session-wrap, 회고]
+estimated_tokens: ~800
+user-invocable: true
+---
+
+# Session Wrap Skill
+
+현재 브랜치의 변경사항을 분석하여 Skill 후보, 학습 포인트, 후속 작업을 자동으로 도출합니다.
+
+<instructions>
+
+## 실행 흐름
+
+### Step 1: Diff 범위 파악
+
+```bash
+# base branch 감지 (main 또는 master)
+BASE=$(git merge-base HEAD main 2>/dev/null || git merge-base HEAD master)
+
+# 변경 통계 수집
+git diff --stat $BASE..HEAD
+git diff --name-only $BASE..HEAD
+git log --oneline $BASE..HEAD
+```
+
+위 명령으로 아래 3가지 데이터를 수집:
+- `DIFF_STAT` — 파일별 변경 라인 통계
+- `DIFF_NAMES` — 변경된 파일 목록
+- `LOG` — 커밋 히스토리
+
+변경사항이 없으면 사용자에게 알리고 종료합니다.
+
+### Step 2: Diff 내용 수집
+
+```bash
+# 전체 diff (너무 크면 --stat만 사용)
+git diff $BASE..HEAD
+```
+
+diff가 5000줄을 초과하면 `--stat`과 `--name-only` 결과만 사용합니다.
+
+### Step 3: 3개 Agent 병렬 호출
+
+아래 3개 Agent를 Task 도구로 **병렬** 호출합니다.
+각 Agent에 Step 1~2에서 수집한 데이터를 프롬프트에 포함하여 전달합니다.
+
+| Agent | 역할 | 기대 출력 |
+|-------|------|----------|
+| `automation-scout` | 반복 패턴 발견, Skill 후보 제안 | Skill 후보 목록 |
+| `learning-extractor` | 학습 포인트 추출, Context/규칙 후보 | Context 문서 + CLAUDE.md 규칙 후보 |
+| `followup-suggester` | 미완성/후속 작업 식별 | 우선순위별 후속 작업 목록 |
+
+각 Agent 프롬프트 구성:
+
+```
+아래는 현재 브랜치의 base branch 대비 변경사항입니다. 분석해주세요.
+
+## 커밋 히스토리
+{LOG}
+
+## 변경 통계
+{DIFF_STAT}
+
+## 변경 내용
+{DIFF or DIFF_NAMES}
+```
+
+### Step 4: 결과 통합
+
+3개 Agent의 결과를 아래 형식으로 통합 정리합니다:
+
+```markdown
+# Session Wrap 분석 결과
+
+## 1. Skill 후보 (automation-scout)
+[automation-scout 결과 요약]
+
+## 2. 학습 포인트 (learning-extractor)
+[learning-extractor 결과 요약]
+
+## 3. 후속 작업 (followup-suggester)
+[followup-suggester 결과 요약]
+```
+
+### Step 5: 사용자에게 적용 항목 선택 제시
+
+AskUserQuestion으로 적용할 항목을 선택받습니다:
+
+```
+분석이 완료되었습니다. 아래 항목 중 적용할 것을 선택해주세요:
+- Skill 생성: [후보 목록]
+- Context 문서 추가: [후보 목록]
+- CLAUDE.md 규칙 추가: [후보 목록]
+- 후속 작업 Issue/Task 생성: [후보 목록]
+```
+
+사용자가 선택한 항목만 실행합니다.
+
+</instructions>
+
+<rules>
+
+| 규칙 | 설명 |
+|------|------|
+| 병렬 실행 필수 | 3개 Agent는 반드시 병렬로 호출하여 속도 최적화 |
+| Diff 크기 제한 | 5000줄 초과 시 stat/names만 전달 |
+| 사용자 선택 우선 | 분석 결과를 자동 적용하지 않고 반드시 선택받기 |
+| 빈 결과 허용 | Agent가 해당 없음을 반환해도 정상 — 해당 섹션 "해당 없음" 표시 |
+
+</rules>
+