jun-claude-code 0.5.0 → 0.6.0

package/dist/__tests__/merge-settings.test.js

@@ -403,6 +403,98 @@ function writeJson(filePath, data) {
         (0, vitest_1.expect)(result.hooks.PreToolUse[0].matcher).toBe('Bash');
         (0, vitest_1.expect)(result.hooks.PreToolUse[1].matcher).toBe('Write');
     });
+    (0, vitest_1.it)('should skip source group when dest group contains all source commands plus extras', () => {
+        const sourceSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    {
+                        hooks: [
+                            { type: 'command', command: 'skill-forced.sh' },
+                            { type: 'command', command: 'workflow-enforced.sh' },
+                        ],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        // Dest has the same commands PLUS an extra custom hook (peon-ping)
+        const destSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    {
+                        hooks: [
+                            { type: 'command', command: 'peon.sh' },
+                            { type: 'command', command: 'skill-forced.sh' },
+                            { type: 'command', command: 'workflow-enforced.sh' },
+                        ],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        // Should remain 1 group, not duplicate
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(1);
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit[0].hooks).toHaveLength(3);
+    });
+    (0, vitest_1.it)('should skip source group when dest has commands split across multiple groups', () => {
+        const sourceSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    {
+                        hooks: [
+                            { type: 'command', command: 'skill-forced.sh' },
+                            { type: 'command', command: 'workflow-enforced.sh' },
+                        ],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        // Dest has the same commands spread across separate groups
+        const destSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    { hooks: [{ type: 'command', command: 'skill-forced.sh' }] },
+                    { hooks: [{ type: 'command', command: 'workflow-enforced.sh' }] },
+                ],
+            },
+        };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        // Should remain 2 groups, source group not duplicated
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(2);
+    });
+    (0, vitest_1.it)('should add source group when dest only has some of its commands', () => {
+        const sourceSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    {
+                        hooks: [
+                            { type: 'command', command: 'skill-forced.sh' },
+                            { type: 'command', command: 'new-hook.sh' },
+                        ],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        // Dest has only one of the two source commands
+        const destSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    { hooks: [{ type: 'command', command: 'skill-forced.sh' }] },
+                ],
+            },
+        };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        // Source group should be added since new-hook.sh is missing
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(2);
+    });
     (0, vitest_1.it)('should dedup when dest has .claude/ paths and source has ~/.claude/ paths', () => {
         const sourceSettings = {
             hooks: {

package/dist/copy.js

@@ -43,7 +43,6 @@ const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
 const crypto = __importStar(require("crypto"));
 const chalk_1 = __importDefault(require("chalk"));
-const utils_1 = require("./utils");
 /**
  * Prompt user for confirmation using readline
  */
@@ -202,13 +201,49 @@ function mergeSettingsJson(sourceDir, destDir, options) {
             destHooks[event] = [];
         }
         const destEntries = destHooks[event];
-        // Build a Set of command keys from existing entries for fast duplicate detection
-        const existingKeys = new Set(destEntries.map((entry) => (0, utils_1.getHookKey)(entry)));
+        // Collect all individual commands from dest entries, grouped by matcher
+        const destCommandsByMatcher = new Map();
+        for (const entry of destEntries) {
+            const matcher = entry.matcher || '';
+            if (!destCommandsByMatcher.has(matcher)) {
+                destCommandsByMatcher.set(matcher, new Set());
+            }
+            const cmds = destCommandsByMatcher.get(matcher);
+            if (entry.hooks && Array.isArray(entry.hooks)) {
+                for (const h of entry.hooks) {
+                    if (h.command)
+                        cmds.add(h.command);
+                }
+            }
+            else if (entry.command) {
+                cmds.add(entry.command);
+            }
+        }
         for (const entry of sourceEntries) {
-            const key = (0, utils_1.getHookKey)(entry);
-            if (!existingKeys.has(key)) {
+            const matcher = entry.matcher || '';
+            const existingCmds = destCommandsByMatcher.get(matcher) || new Set();
+            // Extract all commands from this source entry
+            const sourceCommands = [];
+            if (entry.hooks && Array.isArray(entry.hooks)) {
+                for (const h of entry.hooks) {
+                    if (h.command)
+                        sourceCommands.push(h.command);
+                }
+            }
+            else if (entry.command) {
+                sourceCommands.push(entry.command);
+            }
+            // Skip if all source commands already exist in dest for the same matcher
+            const allExist = sourceCommands.length > 0 && sourceCommands.every((cmd) => existingCmds.has(cmd));
+            if (!allExist) {
                 destEntries.push(entry);
-                existingKeys.add(key);
+                // Track newly added commands for subsequent source entries
+                if (!destCommandsByMatcher.has(matcher)) {
+                    destCommandsByMatcher.set(matcher, existingCmds);
+                }
+                for (const cmd of sourceCommands) {
+                    existingCmds.add(cmd);
+                }
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jun-claude-code",
-  "version": "0.5.0",
+  "version": "0.6.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

@@ -43,21 +43,22 @@ Main agent는 **직접 코드를 읽거나 쓰지 않고**, 아래 역할에 집
 - Critical 이슈 발견 시 해당 단계 subagent 재호출
 - 모든 Git 작업(커밋, PR, 브랜치)은 git-manager에 위임
 
-### Skill 위임 원칙 (skill-forced-subagent.sh 활용)
+### Skill 위임 원칙 (Skills 2.0 Preload)
 
-`SubagentStart` hook(`skill-forced-subagent.sh`)은 subagent가 TaskList에서 자신의 task를 찾아 명시된 skill만 읽도록 안내합니다.
+Agent frontmatter의 `skills` 필드에 선언된 Skill이 Agent 시작 시 자동으로 preload됩니다.
 
-**핵심 원칙**: 형식 규칙을 프롬프트에 직접 쓰지 말고, SKILL.md를 먼저 읽도록 지시하라.
+```yaml
+# 예: code-writer.md frontmatter
+skills: [Coding, Backend, Reporting]
+```
 
-#### Subagent 위임 시 Skill 지시 방법
+**핵심 원칙**: 형식 규칙을 프롬프트에 직접 쓰지 말고, Agent의 `skills` 필드에 선언하라.
 
-subagent 프롬프트에 형식을 직접 쓰는 대신, 아래 패턴을 사용하세요:
+#### Subagent 위임 시 Skill 지시 방법
 
-```
-먼저 해당 task의 Execution Plan에 명시된 skill SKILL.md를 읽고 규칙을 파악한 뒤 작업하세요.
-```
+Agent frontmatter에 `skills` 필드가 설정되어 있으면 별도 지시 불필요.
+추가 Skill 참조가 필요한 경우에만 프롬프트에 명시:
 
-Execution Plan에 skill이 없는 경우:
 ```
 먼저 ~/.claude/skills/ 에서 이 작업과 관련된 SKILL.md를 찾아 읽고 규칙을 따르세요.
 ```
@@ -207,16 +208,11 @@ Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희
 
 ## PHASE 4: 리뷰 (Review) - 구현 후 필수
 
-<checklist>
-
-### Step 4.1: Self Code Review
+> 코드 품질 검토(Skill 규칙 준수, 보안, 에러 핸들링)는 PostToolUse agent hook이 매 Edit/Write마다 자동 수행합니다.
 
-필수 검토:
-- [ ] 프로젝트 규칙 준수 확인
-- [ ] Skill checklist 기준 검토
-- [ ] lint 실행
+<checklist>
 
-### Step 4.2: Task 완료 검증
+### Step 4.1: Task 완료 검증
 
 - [ ] 원래 요청사항이 모두 충족되었는지 확인
 - [ ] 예상한 동작이 구현되었는지 확인

package/templates/global/agents/code-reviewer.md

@@ -4,6 +4,9 @@ description: 코드 작성 완료 후 품질 검토 시 호출. CLAUDE.md/Skills
 keywords: [코드리뷰, 체크리스트, lint, 규칙검증, 품질검사, Critical, Warning, 수정제안]
 model: opus
 color: yellow
+disallowedTools: [Edit, Write, NotebookEdit]
+skills: [Coding, Reporting]
+memory: project
 ---
 
 # Code Reviewer Agent

package/templates/global/agents/code-writer.md

@@ -4,6 +4,23 @@ description: 로직 작성, 기능 구현, 리팩토링 등 코드 수정이 필
 keywords: [코드작성, 구현, 개발, Entity, Service, Controller, 컴포넌트, TypeScript, React, 훅, 페이지]
 model: opus
 color: cyan
+skills: [Coding, Backend, Reporting]
+permissionMode: acceptEdits
+memory: project
+hooks:
+  PostToolUse:
+    - matcher: "Edit|Write"
+      hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "코드 품질 리뷰어로서 아래 단계를 수행하세요.\n\nStep 1: ~/.claude/skills/ 와 .claude/skills/ 두 디렉토리의 SKILL.md 파일 목록을 스캔하세요. 변경된 파일의 타입과 내용을 기준으로 관련 Skill을 판별하세요 (예: Coding, Backend, React 등).\n\nStep 2: 관련 SKILL.md를 읽고 규칙을 파악하세요.\n\nStep 3: 변경된 파일을 읽고 코드 변경 내용을 맥락과 함께 리뷰하세요.\n\nStep 4: 아래 항목을 검토하세요:\n- Skill에 명시된 규칙 위반 여부\n- 실패 가능한 작업의 에러 핸들링 누락\n- 보안 문제 (인젝션, XSS, 하드코딩된 시크릿)\n- 명백한 로직 오류 또는 오타\n\n문제 발견 시: {\"ok\": false, \"reason\": \"구체적 이슈와 개선 제안\"}\n문제 없을 시: {\"ok\": true}\n\n실제 문제만 지적하세요. 스타일, 네이밍, 사소한 선호도는 지적하지 마세요."
+          timeout: 60
+  Stop:
+    - hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "작업 완료 후 다음 단계를 추천하는 어드바이저로서 아래를 수행하세요.\n\n<steps>\n\nStep 1: 아래 소스를 순서대로 확인하세요.\n- .claude/plan/ 폴더의 plan.md, checklist.md (존재 시)\n- TaskList (TaskList 도구 사용)\n- 최근 git log 5건 (git log --oneline -5)\n\nStep 2: 현재 상태를 판단하세요.\n- 미완료 Task가 있는가?\n- checklist에 체크되지 않은 항목이 있는가?\n- 최근 커밋 흐름에서 논리적 다음 단계가 보이는가?\n\nStep 3: 다음 작업을 2-3개 추천하세요.\n\n</steps>\n\n<output_format>\n\n## 추천 다음 작업\n\n| 우선순위 | 작업 | 근거 |\n|---------|------|------|\n| 1 | ... | ... |\n| 2 | ... | ... |\n| 3 | ... | ... |\n\n</output_format>\n\n<rules>\n- Plan/TaskList가 모두 없고 단순 질문 응답인 경우: 추천 없이 빈 응답 반환\n- 추천은 구체적이고 실행 가능해야 한다\n- 150줄 이내로 출력한다\n</rules>"
+          timeout: 60
 ---
 
 # Code Writer Agent

package/templates/global/agents/context-collector.md

@@ -1,9 +1,13 @@
 ---
 name: context-collector
 description: 소스 코드에서 패턴/구현 방식/도메인 지식을 수집. 파일 내용 분석/정리, Skill/Agent 식별, 코드 DEEP 탐색 전문.
+skills: [Reporting]
 keywords: [코드탐색, 패턴파악, Skill식별, 도메인지식, 아키텍처분석, DEEP탐색, 소스코드]
 model: opus
 color: blue
+disallowedTools: [Edit, Write, NotebookEdit]
+permissionMode: plan
+maxTurns: 20
 ---
 
 # Context Collector Agent

package/templates/global/agents/context-manager.md

@@ -4,6 +4,7 @@ description: 기존 .claude/context/ 문서의 구조 최적화 시 호출. 큰
 keywords: [Context관리, 문서정리, 파일분리, 토큰최적화, 구조개선, 문서품질]
 model: sonnet
 color: green
+skills: [Reporting]
 ---
 
 # Context Manager Agent
@@ -82,7 +83,6 @@ INDEX 파일에는 **핵심 요약**만 포함:
 name: domain-order-index
 description: 주문 도메인 개요
 keywords: [주문, Order, 결제, Payment]
-estimated_tokens: ~200
 ---
 
 # 주문 도메인

package/templates/global/agents/designer.md

@@ -4,6 +4,15 @@ description: UI 컴포넌트 구조 설계나 스타일링 작업 시 호출.
 keywords: [UI, UX, 스타일링, 컴포넌트, 레이아웃, 반응형, 디자인시스템]
 model: sonnet
 color: pink
+skills: [React, Reporting]
+hooks:
+  PostToolUse:
+    - matcher: "Edit|Write"
+      hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "코드 품질 리뷰어로서 아래 단계를 수행하세요.\n\nStep 1: ~/.claude/skills/ 와 .claude/skills/ 두 디렉토리의 SKILL.md 파일 목록을 스캔하세요. 변경된 파일의 타입과 내용을 기준으로 관련 Skill을 판별하세요 (예: Coding, Backend, React 등).\n\nStep 2: 관련 SKILL.md를 읽고 규칙을 파악하세요.\n\nStep 3: 변경된 파일을 읽고 코드 변경 내용을 맥락과 함께 리뷰하세요.\n\nStep 4: 아래 항목을 검토하세요:\n- Skill에 명시된 규칙 위반 여부\n- 실패 가능한 작업의 에러 핸들링 누락\n- 보안 문제 (인젝션, XSS, 하드코딩된 시크릿)\n- 명백한 로직 오류 또는 오타\n\n문제 발견 시: {\"ok\": false, \"reason\": \"구체적 이슈와 개선 제안\"}\n문제 없을 시: {\"ok\": true}\n\n실제 문제만 지적하세요. 스타일, 네이밍, 사소한 선호도는 지적하지 마세요."
+          timeout: 60
 ---
 
 # Designer Agent

package/templates/global/agents/explore.md

@@ -1,9 +1,13 @@
 ---
 name: explore
 description: 파일 위치/코드 검색이 필요할 때 호출. Glob/Grep으로 빠른 탐색, 파일 구조 파악. 내용 분석/정리는 context-collector 사용.
+skills: [Reporting]
 keywords: [탐색, 검색, 파일찾기, 패턴매칭, 구조파악, Glob, Grep, 빠른검색]
 model: haiku
 color: gray
+disallowedTools: [Edit, Write, NotebookEdit]
+permissionMode: plan
+maxTurns: 5
 ---
 
 # Explore Agent

package/templates/global/agents/git-manager.md

@@ -4,6 +4,19 @@ description: 모든 Git 작업 시 필수 호출. 커밋 메시지 작성, PR
 keywords: [커밋, PR생성, 브랜치, push, merge, git, GitHub, 풀리퀘스트, FEAT, FIX, REFACTOR]
 model: sonnet
 color: purple
+skills: [Git, Reporting]
+hooks:
+  PostToolUse:
+    - matcher: "Bash"
+      hooks:
+        - type: command
+          command: "~/.claude/hooks/session-wrap-suggester.sh"
+  Stop:
+    - hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "작업 완료 후 다음 단계를 추천하는 어드바이저로서 아래를 수행하세요.\n\n<steps>\n\nStep 1: 아래 소스를 순서대로 확인하세요.\n- .claude/plan/ 폴더의 plan.md, checklist.md (존재 시)\n- TaskList (TaskList 도구 사용)\n- 최근 git log 5건 (git log --oneline -5)\n\nStep 2: 현재 상태를 판단하세요.\n- 미완료 Task가 있는가?\n- checklist에 체크되지 않은 항목이 있는가?\n- 최근 커밋 흐름에서 논리적 다음 단계가 보이는가?\n\nStep 3: 다음 작업을 2-3개 추천하세요.\n\n</steps>\n\n<output_format>\n\n## 추천 다음 작업\n\n| 우선순위 | 작업 | 근거 |\n|---------|------|------|\n| 1 | ... | ... |\n| 2 | ... | ... |\n| 3 | ... | ... |\n\n</output_format>\n\n<rules>\n- Plan/TaskList가 모두 없고 단순 질문 응답인 경우: 추천 없이 빈 응답 반환\n- 추천은 구체적이고 실행 가능해야 한다\n- 150줄 이내로 출력한다\n</rules>"
+          timeout: 60
 ---
 
 # Git Manager Agent

package/templates/global/agents/impact-analyzer.md

@@ -1,9 +1,11 @@
 ---
 name: impact-analyzer
 description: 코드 수정 전 영향 범위 파악 시 호출. 호출 관계 추적, API 변경 영향, Breaking Change 탐지, 위험도 HIGH/MEDIUM/LOW 평가.
+skills: [Reporting]
 keywords: [사이드이펙트, CodeFlow, UserFlow, BreakingChange, 영향분석, 위험도평가, 호출관계, API변경]
 model: opus
 color: orange
+disallowedTools: [Edit, Write, NotebookEdit]
 ---
 
 # Impact Analyzer Agent

package/templates/global/agents/plan-verifier.md

@@ -1,9 +1,12 @@
 ---
 name: plan-verifier
 description: Plan 수립 후 구현 전에 Plan 품질을 검증하는 Agent. 목적 정합성, 완전성, 논리적 일관성, 실현 가능성, 스코프 초과 여부를 코드베이스 탐색을 통해 능동적으로 검증.
+skills: [Reporting]
 keywords: [Plan검증, 목적정합성, 완전성, 논리적일관성, 실현가능성, 스코프검증, PlanReview]
 model: opus
 color: cyan
+disallowedTools: [Edit, Write, NotebookEdit]
+permissionMode: plan
 ---
 
 # Plan Verifier Agent

package/templates/global/agents/qa-tester.md

@@ -1,9 +1,18 @@
 ---
 name: qa-tester
 description: 구현 완료 후 품질 검증 시 호출. 빌드 성공 확인, 단위/통합 테스트 실행, lint 검사, E2E 시나리오 검증 수행.
+skills: [Reporting]
 keywords: [테스트, QA, 품질검증, lint, 빌드, E2E, 시나리오테스트, 검증]
 model: sonnet
 color: teal
+maxTurns: 20
+hooks:
+  Stop:
+    - hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "작업 완료 후 다음 단계를 추천하는 어드바이저로서 아래를 수행하세요.\n\n<steps>\n\nStep 1: 아래 소스를 순서대로 확인하세요.\n- .claude/plan/ 폴더의 plan.md, checklist.md (존재 시)\n- TaskList (TaskList 도구 사용)\n- 최근 git log 5건 (git log --oneline -5)\n\nStep 2: 현재 상태를 판단하세요.\n- 미완료 Task가 있는가?\n- checklist에 체크되지 않은 항목이 있는가?\n- 최근 커밋 흐름에서 논리적 다음 단계가 보이는가?\n\nStep 3: 다음 작업을 2-3개 추천하세요.\n\n</steps>\n\n<output_format>\n\n## 추천 다음 작업\n\n| 우선순위 | 작업 | 근거 |\n|---------|------|------|\n| 1 | ... | ... |\n| 2 | ... | ... |\n| 3 | ... | ... |\n\n</output_format>\n\n<rules>\n- Plan/TaskList가 모두 없고 단순 질문 응답인 경우: 추천 없이 빈 응답 반환\n- 추천은 구체적이고 실행 가능해야 한다\n- 150줄 이내로 출력한다\n</rules>"
+          timeout: 60
 ---
 
 # QA Tester Agent

package/templates/global/agents/simple-code-writer.md

@@ -4,6 +4,23 @@ description: lint/build 오류, 오타, 설정값 등 간단한 코드 수정
 keywords: [간단수정, 단순수정, 설정변경, 오타수정, 1-2파일, 소규모수정]
 model: haiku
 color: cyan
+skills: [Coding, Reporting]
+permissionMode: acceptEdits
+maxTurns: 10
+hooks:
+  PostToolUse:
+    - matcher: "Edit|Write"
+      hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "코드 품질 리뷰어로서 아래 단계를 수행하세요.\n\nStep 1: ~/.claude/skills/ 와 .claude/skills/ 두 디렉토리의 SKILL.md 파일 목록을 스캔하세요. 변경된 파일의 타입과 내용을 기준으로 관련 Skill을 판별하세요 (예: Coding, Backend, React 등).\n\nStep 2: 관련 SKILL.md를 읽고 규칙을 파악하세요.\n\nStep 3: 변경된 파일을 읽고 코드 변경 내용을 맥락과 함께 리뷰하세요.\n\nStep 4: 아래 항목을 검토하세요:\n- Skill에 명시된 규칙 위반 여부\n- 실패 가능한 작업의 에러 핸들링 누락\n- 보안 문제 (인젝션, XSS, 하드코딩된 시크릿)\n- 명백한 로직 오류 또는 오타\n\n문제 발견 시: {\"ok\": false, \"reason\": \"구체적 이슈와 개선 제안\"}\n문제 없을 시: {\"ok\": true}\n\n실제 문제만 지적하세요. 스타일, 네이밍, 사소한 선호도는 지적하지 마세요."
+          timeout: 60
+  Stop:
+    - hooks:
+        - type: agent
+          model: claude-sonnet-4-6
+          prompt: "작업 완료 후 다음 단계를 추천하는 어드바이저로서 아래를 수행하세요.\n\n<steps>\n\nStep 1: 아래 소스를 순서대로 확인하세요.\n- .claude/plan/ 폴더의 plan.md, checklist.md (존재 시)\n- TaskList (TaskList 도구 사용)\n- 최근 git log 5건 (git log --oneline -5)\n\nStep 2: 현재 상태를 판단하세요.\n- 미완료 Task가 있는가?\n- checklist에 체크되지 않은 항목이 있는가?\n- 최근 커밋 흐름에서 논리적 다음 단계가 보이는가?\n\nStep 3: 다음 작업을 2-3개 추천하세요.\n\n</steps>\n\n<output_format>\n\n## 추천 다음 작업\n\n| 우선순위 | 작업 | 근거 |\n|---------|------|------|\n| 1 | ... | ... |\n| 2 | ... | ... |\n| 3 | ... | ... |\n\n</output_format>\n\n<rules>\n- Plan/TaskList가 모두 없고 단순 질문 응답인 경우: 추천 없이 빈 응답 반환\n- 추천은 구체적이고 실행 가능해야 한다\n- 150줄 이내로 출력한다\n</rules>"
+          timeout: 60
 ---
 
 # Simple Code Writer Agent

package/templates/global/agents/task-enricher.md

@@ -1,9 +1,11 @@
 ---
 name: task-enricher
 description: task-planner가 생성한 TaskList의 각 Task에 subagent 실행 계획(순차/병렬 조합)과 참조 skill을 할당. Main agent가 PM으로 여러 subagent를 조율할 수 있도록 Execution Plan을 작성.
+skills: [Reporting]
 keywords: [TaskList, agent할당, skill할당, task분석, 위임계획, 실행순서, PM, 병렬, 순차]
 model: opus
 color: purple
+disallowedTools: [Edit, Write, NotebookEdit]
 ---
 
 <role>

package/templates/global/agents/task-planner.md

@@ -1,9 +1,11 @@
 ---
 name: task-planner
 description: 복잡한 작업 시작 전 계획 수립 시 호출. 요구사항 명확화 질문, TaskList 생성, 파일별 수정 계획 작성, 의존성 순서 정의.
+skills: [Reporting]
 keywords: [TaskList, 계획수립, 요구사항명확화, 작업분해, 질문, 수정계획, 파일목록, 의존성]
 model: opus
 color: green
+disallowedTools: [Edit, Write, NotebookEdit]
 ---
 
 # Task Planner Agent

package/templates/global/settings.json

@@ -18,16 +18,6 @@
         ]
       }
     ],
-    "SubagentStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/hooks/skill-forced-subagent.sh"
-          }
-        ]
-      }
-    ],
     "PreToolUse": [
       {
         "matcher": "Bash",
@@ -38,26 +28,6 @@
           }
         ]
       }
-    ],
-    "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/Backend/SKILL.md

@@ -2,7 +2,7 @@
 name: Backend
 description: NestJS/TypeORM 백엔드 개발 시 사용. 레이어 객체 변환, find vs queryBuilder 선택 기준, BDD 테스트 작성 규칙 제공.
 keywords: [Backend, 백엔드, 레이어, DTO, Entity, Service, Controller, TypeORM, find, queryBuilder, test, BDD, 테스트, Jest]
-estimated_tokens: ~400
+user-invocable: false
 ---
 
 # 백엔드 개발 원칙

package/templates/global/skills/Backend/bdd-testing.md

@@ -2,7 +2,6 @@
 name: bdd-testing
 description: NestJS + Jest BDD 스타일 테스트 작성 시 사용. describe 네스팅 구조, Given/When/Then 패턴, Testing Module Mock 설정 규칙 제공.
 keywords: [BDD, test, 테스트, Jest, NestJS, describe, it, Given, When, Then, mock, TestingModule]
-estimated_tokens: ~500
 ---
 
 # BDD 테스트 작성 규칙

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

@@ -2,7 +2,7 @@
 name: Coding
 description: 모든 코드 작성 시 참조. SRP/결합도/응집도 판단 기준, 폴더 구조 설계 원칙, 삼항연산자/try-catch 가독성 규칙 제공.
 keywords: [SRP, 단일책임, 결합도, 응집도, 설계원칙, 폴더구조, 아키텍처, 가독성, 삼항연산자, try-catch]
-estimated_tokens: ~500
+user-invocable: false
 ---
 
 # 공통 코딩 원칙

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

@@ -2,7 +2,9 @@
 name: context-handoff
 description: 컨텍스트 압축을 위한 HANDOFF.md 작성 가이드
 keywords: [HANDOFF, 컨텍스트, context, 압축, handoff, 세션, clear, 토큰]
-estimated_tokens: ~300
+user-invocable: true
+disable-model-invocation: true
+argument-hint: "[handoff-name]"
 ---
 
 # Context Handoff

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

@@ -2,7 +2,7 @@
 name: Director
 description: 프로젝트 스펙/기획 문서 작성 구조, 검증 규칙, 충돌 탐지 가이드라인 제공.
 keywords: [프로젝트스펙, 기획문서, 검증규칙, 충돌탐지, spec]
-estimated_tokens: ~600
+user-invocable: false
 ---
 
 # Director Skill

package/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: ~1200
+user-invocable: false
 ---
 
 # .claude 문서 작성 스킬
@@ -54,7 +54,6 @@ estimated_tokens: ~1200
 name: file-name              # 파일 식별자 (kebab-case)
 description: 한 줄 설명       # 파일 목적 (50자 이내)
 keywords: [키워드1, 키워드2]  # 검색/매칭용 (한글, 영문 혼용)
-estimated_tokens: ~500       # 예상 토큰 수
 ---
 ```
 
@@ -102,7 +101,6 @@ user-invocable: true         # 사용자가 /skill-name으로 호출 가능
 name: context-name
 description: 설명
 keywords: [키워드1, 키워드2]
-estimated_tokens: ~300
 ---
 
 # 제목
@@ -141,7 +139,6 @@ estimated_tokens: ~300
 name: skill-name
 description: 설명
 keywords: [키워드1, 키워드2]
-estimated_tokens: ~400
 ---
 
 # 스킬 제목

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

@@ -2,7 +2,7 @@
 name: Git
 description: 커밋/PR/브랜치 작업 시 사용. FEAT/FIX/REFACTOR 메시지 규칙, PR 템플릿, 리뷰 체크리스트 인덱스 제공.
 keywords: [커밋, PR, 브랜치, push, merge, FEAT, FIX, 코드리뷰, PR리뷰, 피드백]
-estimated_tokens: ~100
+user-invocable: true
 ---
 
 # Git 작업 스킬

package/templates/global/skills/Git/git.md

@@ -2,7 +2,6 @@
 name: git
 description: Git 작업 가이드. Commit 메시지 작성법, PR 작성법, 브랜치 전략, 안전 규칙.
 keywords: [커밋, PR, 브랜치, push, merge, FEAT, FIX, REFACTOR, CHORE, DOCS, GitHub, 풀리퀘스트]
-estimated_tokens: ~600
 ---
 
 # Git 작업 가이드

package/templates/global/skills/Git/pr-apply.md

@@ -2,10 +2,15 @@
 name: pr-apply
 description: PR 리뷰 피드백 적용 스킬. 리뷰 코멘트 확인, 코드 수정, 커밋 생성.
 keywords: [PR피드백, 리뷰적용, 코드수정, 코멘트, 변경요청, 재커밋]
-estimated_tokens: ~250
 user-invocable: true
+context: fork
+argument-hint: "[PR-number]"
 ---
 
+## PR Context
+- Diff: !`gh pr diff $ARGUMENTS`
+- Comments: !`gh pr view $ARGUMENTS --comments`
+
 # PR Apply Skill
 
 PR 리뷰 피드백을 코드에 반영하는 가이드.

package/templates/global/skills/Git/pr-review.md

@@ -2,10 +2,16 @@
 name: pr-review
 description: PR 코드 리뷰 스킬. 체크리스트 기반 구조적 리뷰 수행.
 keywords: [PR리뷰, 코드리뷰, MR, 머지리퀘스트, 체크리스트, Critical, Warning, Approved]
-estimated_tokens: ~300
 user-invocable: true
+context: fork
+agent: code-reviewer
+argument-hint: "[PR-number]"
 ---
 
+## PR Context
+- Diff: !`gh pr diff $ARGUMENTS`
+- Description: !`gh pr view $ARGUMENTS`
+
 # PR Review Skill
 
 체크리스트 기반 Pull Request 리뷰.

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

@@ -2,7 +2,7 @@
 name: PromptStructuring
 description: "Claude Code 프롬프트의 XML 태그 구조화, 긍정 표현 전환, 출력 최적화 가이드"
 keywords: [prompt, xml-tags, positive-phrasing, output-optimization, 프롬프트, 구조화, 긍정표현, XML, 출력최적화]
-estimated_tokens: 300
+user-invocable: false
 ---
 
 # 프롬프트 구조화 스킬
@@ -17,3 +17,4 @@ estimated_tokens: 300
 | 2. 긍정 표현 | "~금지" 대신 "~한다"로 행동 직접 유도 | `positive-phrasing.md` |
 | 3. 흐름 기호 | 단계/변환/위임에 `->` 사용: 계획 -> 구현 -> 검증 | - |
 | 4. 출력 최적화 | 반복 제거, 테이블 > 산문, Hook 출력 150줄 이내 | `output-optimization.md` |
+| 5. Frontmatter | Skill/Agent YAML frontmatter 필드 선택과 작성 기준 | `skills-frontmatter.md` |

package/templates/global/skills/PromptStructuring/output-optimization.md

@@ -2,7 +2,6 @@
 name: PromptStructuring-output-optimization
 description: "Hook/프롬프트 출력의 토큰 최적화 기법과 가이드라인"
 keywords: [output, optimization, hook, 토큰절약, 출력최적화, 슬림화]
-estimated_tokens: 500
 ---
 
 # 출력 최적화 가이드

package/templates/global/skills/PromptStructuring/positive-phrasing.md

@@ -2,7 +2,6 @@
 name: PromptStructuring-positive-phrasing
 description: "부정 표현을 긍정 표현으로 전환하는 패턴과 체크리스트"
 keywords: [positive, phrasing, 긍정표현, 부정표현, 전환]
-estimated_tokens: 350
 ---
 
 # 긍정 표현 전환 가이드

package/templates/global/skills/PromptStructuring/skills-frontmatter.md

@@ -0,0 +1,173 @@
+---
+name: PromptStructuring-skills-frontmatter
+description: Skills 2.0 Skill/Agent frontmatter 필드 레퍼런스. 작성 시 필드 선택 기준과 예시 제공.
+keywords: [frontmatter, SKILL.md, agent, yaml, skills-2.0, hooks, context-fork, tools, permissionMode]
+user-invocable: false
+---
+
+# Skills/Agent Frontmatter 레퍼런스
+
+SKILL.md와 Agent .md 파일의 YAML frontmatter 필드 가이드.
+
+## Skill Frontmatter (SKILL.md)
+
+<fields>
+
+| 필드 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `name` | string | 디렉토리명 | 스킬 이름. `/slash-command`가 됨. 소문자+하이픈, 최대 64자 |
+| `description` | string | 첫 단락 | 용도 및 트리거 조건. Claude가 자동 호출 판단에 사용 |
+| `argument-hint` | string | - | 자동완성 시 인자 힌트. 예: `[PR-number]` |
+| `disable-model-invocation` | boolean | `false` | `true` -> Claude 자동 호출 차단. description이 컨텍스트에 로딩되지 않아 토큰 절약 |
+| `user-invocable` | boolean | `true` | `false` -> `/` 메뉴에서 숨김. Claude만 자동 호출 가능 |
+| `allowed-tools` | array | 전체 상속 | Skill 활성 시 허용 도구 제한. 예: `[Read, Grep, Glob]` |
+| `model` | string | `inherit` | `sonnet`, `opus`, `haiku`, 모델 ID, `inherit` |
+| `context` | string | - | `fork` -> 격리된 subagent에서 실행 |
+| `agent` | string | `general-purpose` | `context: fork` 시 사용할 agent 타입 |
+| `hooks` | object | - | Skill 라이프사이클에 스코프된 훅 |
+
+</fields>
+
+### 호출 제어 매트릭스
+
+| 설정 | 사용자 호출 | Claude 호출 | 컨텍스트 로딩 |
+|------|:-:|:-:|------|
+| (기본값) | O | O | description 항상 로드, 호출 시 전체 로드 |
+| `disable-model-invocation: true` | O | X | description 미로드 -> 토큰 절약 |
+| `user-invocable: false` | X | O | description 항상 로드, 호출 시 전체 로드 |
+
+### 치환 변수
+
+| 변수 | 설명 |
+|------|------|
+| `$ARGUMENTS` | Skill 호출 시 전달된 모든 인자 |
+| `$ARGUMENTS[N]` / `$N` | N번째 인자 (0-based) |
+| `${CLAUDE_SESSION_ID}` | 현재 세션 ID |
+| `${CLAUDE_SKILL_DIR}` | SKILL.md가 위치한 디렉토리 경로 |
+
+### Dynamic Context Injection
+
+셸 명령을 즉시 실행하여 결과를 프롬프트에 주입한다.
+
+```yaml
+---
+name: pr-review
+context: fork
+agent: general-purpose
+argument-hint: "[PR-number]"
+---
+## PR Context
+- Diff: !`gh pr diff $ARGUMENTS`
+- Description: !`gh pr view $ARGUMENTS`
+```
+
+`` !`command` `` -> 실행 결과로 치환 -> Claude가 완성된 프롬프트를 수신.
+
+## Agent Frontmatter (.claude/agents/*.md)
+
+<fields>
+
+| 필드 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `name` | string | **필수** | Agent 이름. 소문자+하이픈 |
+| `description` | string | **필수** | 위임 판단 기준. 언제 이 Agent를 사용하는지 명시 |
+| `disallowedTools` | array | - | 명시적 거부 도구 목록 |
+| `model` | string | `inherit` | `sonnet`, `opus`, `haiku`, 모델 ID |
+| `permissionMode` | string | `default` | 권한 모드 |
+| `maxTurns` | number | - | 최대 턴 수. 초과 시 결과 반환 후 종료 |
+| `skills` | array | - | 시작 시 사전 로드할 Skill 목록 |
+| `mcpServers` | object/array | - | 사용 가능 MCP 서버 |
+| `hooks` | object | - | Agent 라이프사이클 훅 |
+| `memory` | string | - | 영속 메모리 스코프: `user`, `project`, `local` |
+| `background` | boolean | `false` | `true` -> 백그라운드 작업으로 실행 |
+| `isolation` | string | - | `worktree` -> 임시 git worktree에서 격리 실행 |
+
+</fields>
+
+### permissionMode 옵션
+
+| 모드 | 동작 | 적용 대상 예시 |
+|------|------|------------|
+| `default` | 표준 권한 확인 | 기본값 |
+| `plan` | 읽기 전용 탐색 | explore, context-collector |
+| `acceptEdits` | 파일 수정 자동 승인 | code-writer, simple-code-writer |
+| `dontAsk` | 권한 프롬프트 자동 거부 | - |
+| `bypassPermissions` | 모든 권한 검사 건너뜀 | 주의 필요 |
+
+### skills preload
+
+Agent 시작 시 Skill 전체 내용을 컨텍스트에 주입한다.
+
+```yaml
+# code-writer.md
+skills: [Coding, Backend]
+
+# git-manager.md
+skills: [Git]
+```
+
+-> hook으로 "Skill을 먼저 읽으세요"라고 안내하는 간접 방식 대신, frontmatter로 자동 주입.
+
+## Hooks in Skills/Agents
+
+Skill과 Agent의 frontmatter에 `hooks` 필드를 정의하면 해당 컴포넌트가 활성화된 동안에만 실행된다.
+
+<rules>
+
+- 모든 hook 이벤트 지원: PreToolUse, PostToolUse, Stop, UserPromptSubmit 등
+- Agent의 `Stop` hook은 자동으로 `SubagentStop`으로 변환
+- `once: true` 옵션: Skill 전용, 세션당 1회만 실행
+- 형식은 settings.json hooks와 동일하되 YAML로 작성
+
+</rules>
+
+### 예시: Agent에 hooks 추가
+
+```yaml
+---
+name: git-manager
+skills: [Git]
+hooks:
+  PostToolUse:
+    - matcher: "Bash"
+      hooks:
+        - type: command
+          command: "~/.claude/hooks/session-wrap-suggester.sh"
+---
+```
+
+### 예시: Skill에 hooks 추가
+
+```yaml
+---
+name: secure-deploy
+description: 보안 검증 후 배포
+hooks:
+  PreToolUse:
+    - matcher: "Bash"
+      hooks:
+        - type: command
+          command: "./scripts/security-check.sh"
+---
+```
+
+## 미존재 필드 (FAQ)
+
+| 필드 | 상태 |
+|------|------|
+| `import` / `imports` | 존재하지 않음. `skills` preload, 지원 파일, dynamic injection으로 대체 |
+| `include` / `require` | 존재하지 않음 |
+| `dependencies` | 런타임 패키지 의존성용. Skill 간 참조용 아님 |
+| `extends` | 존재하지 않음 |
+| `estimated_tokens` | 공식 필드 아님. 사용하지 않음 |
+| `tools` (Agent) | `disallowedTools`만 사용하여 최대한 도구 활용 |
+
+## Skill 콘텐츠 유형 가이드
+
+| 유형 | 설명 | 실행 방식 | 예시 |
+|------|------|----------|------|
+| 참조 콘텐츠 | 규칙, 패턴, 스타일 가이드 | 인라인 (메인 컨텍스트) | Coding, Backend, React |
+| 작업 콘텐츠 | 배포, 커밋, 코드 생성 | `context: fork` 또는 직접 호출 | deploy, pr-review |
+
+참조 콘텐츠는 `user-invocable: false`로 배경 지식으로 활용한다.
+작업 콘텐츠는 `disable-model-invocation: true`로 수동 트리거만 허용한다.

package/templates/global/skills/PromptStructuring/xml-tags.md

@@ -2,7 +2,6 @@
 name: PromptStructuring-xml-tags
 description: "XML 태그 표준 목록, 파일 유형별 권장 조합"
 keywords: [xml, tags, role, instructions, rules, constraints]
-estimated_tokens: 400
 ---
 
 # XML 태그 표준

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

@@ -2,7 +2,7 @@
 name: React
 description: React 컴포넌트 작성 시 사용. 파일/폴더 구조, useState/useEffect 규칙, props 설계, 렌더링 최적화 기법 제공.
 keywords: [React, 컴포넌트, useState, useEffect, 훅, props, 상태관리, 렌더링, 최적화]
-estimated_tokens: ~600
+user-invocable: false
 ---
 
 # React 개발 스킬

package/templates/global/skills/React/react-hook-form.md

@@ -2,7 +2,6 @@
 name: react-hook-form
 description: 폼 구현 시 사용. Zod 스키마 정의, useForm 훅 설정, 필드 에러 처리, TRPC mutation 연동 패턴 제공.
 keywords: [react-hook-form, zod, form, 폼, validation, 검증, useForm, register, handleSubmit]
-estimated_tokens: ~500
 ---
 
 # React Hook Form + Zod 패턴

package/templates/global/skills/React/tailwind-styled.md

@@ -2,7 +2,6 @@
 name: tailwind-styled
 description: tailwind-styled-components로 스타일링 시 사용. DOM depth 최소화 원칙, wrapper 제거 패턴, 조건부 스타일 적용법 제공.
 keywords: [tailwind, styled-components, tw, DOM, depth, wrapper, 스타일링]
-estimated_tokens: ~350
 ---
 
 # tailwind-styled-components 스킬

package/templates/global/skills/React/tanstack-router.md

@@ -2,7 +2,6 @@
 name: tanstack-router
 description: TanStack Router로 라우팅 구현 시 사용. 파일 기반 라우트 구조, 동적 경로, beforeLoad 인증 guard 패턴 제공.
 keywords: [tanstack, router, 라우팅, 파일기반, createFileRoute, navigate, beforeLoad, guard]
-estimated_tokens: ~450
 ---
 
 # TanStack Router 패턴

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

@@ -2,7 +2,7 @@
 name: Reporting
 description: Subagent 보고 형식 가이드. Discoveries/Changes/Reasoning 3축 구조화, Agent 유형별 출력 템플릿 제공.
 keywords: [보고, 리포트, Discoveries, Changes, Reasoning, subagent, 출력형식]
-estimated_tokens: ~600
+user-invocable: false
 ---
 
 # Subagent 보고 형식

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

@@ -2,8 +2,9 @@
 name: session-wrap
 description: PR diff 기반으로 반복 패턴, 학습 포인트, 후속 작업을 분석하여 Skill/Context 후보를 제안
 keywords: [세션정리, PR분석, 자동화, 학습, 후속작업, session-wrap, 회고]
-estimated_tokens: ~800
 user-invocable: true
+disable-model-invocation: true
+context: fork
 ---
 
 # Session Wrap Skill

package/templates/project/skills/ContextGeneration/SKILL.md

@@ -2,7 +2,6 @@
 name: ContextGeneration
 description: PR 변경 내용을 분석하여 .claude/context/ 문서를 자동 생성하는 규칙
 keywords: [context, codebase, business, PR, 자동생성, 문서화]
-estimated_tokens: ~800
 ---
 
 # Context 자동 생성 규칙

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

@@ -1,40 +0,0 @@
-#!/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/skill-forced-subagent.sh

@@ -1,98 +0,0 @@
-#!/bin/bash
-
-# .claude/hooks/skill-forced-subagent.sh
-# Subagent용 Skill 평가 프로토콜 - SubagentStart hook
-# Subagent가 작업 시작 전 관련 Skills를 평가하고 활성화하도록 유도
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
-GLOBAL_CLAUDE_DIR="$HOME/.claude"
-PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
-PROJECT_CLAUDE_DIR="${PROJECT_ROOT:-.}/.claude"
-
-# Dedup: project 우선, global은 project 버전 존재 시 양보
-if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then
-  source "$SCRIPT_DIR/_dedup.sh"
-  _hook_dedup_check "${BASH_SOURCE[0]}" || exit 0
-fi
-
-echo "✅ [Hook] Subagent Skill 평가 프로토콜 실행됨"
-
-cat << 'EOF'
-SKILL EVALUATION (Subagent)
-
-<phase name="Skill 평가">
-
-## Skill 참조 방법
-
-### 우선: TaskList에서 명시된 Skill 확인
-
-현재 실행 중인 task의 `## Execution Plan` 섹션을 확인하세요.
-task description에 skill 경로가 명시되어 있다면 해당 Skill만 읽으세요.
-
-확인 방법:
-1. `TaskList` 도구로 현재 task 목록 조회
-2. 자신이 담당한 task 찾기 (description의 Execution Plan 확인)
-3. 해당 subagent 항목의 `skill:` 필드에 명시된 SKILL.md만 읽기
-
-### 폴백: Task에 Skill 정보 없을 경우
-
-task description에 Execution Plan이 없거나 skill이 "없음"으로 명시된 경우,
-아래 전체 Skill 목록에서 현재 작업과 관련된 Skill을 YES/NO로 평가하세요.
-
-### 사용 가능한 Skills (자동 탐색됨)
-
-</phase>
-EOF
-
-# skills 폴더에서 SKILL.md 파일들의 frontmatter 자동 탐색
-# 프로젝트 .claude/ 와 ~/.claude/ 양쪽에서 탐색 (프로젝트 우선, 중복 제거)
-SEEN_SKILLS=""
-for search_dir in "$PROJECT_CLAUDE_DIR" "$GLOBAL_CLAUDE_DIR"; do
-  if [ -d "$search_dir/skills" ]; then
-    for skill_dir in "$search_dir/skills"/*/; do
-      if [ -d "$skill_dir" ]; then
-        skill_name=$(basename "$skill_dir")
-        skill_file="$skill_dir/SKILL.md"
-
-        # 이미 탐색된 Skill은 건너뜀
-        case "$SEEN_SKILLS" in
-          *"|${skill_name}|"*) continue ;;
-        esac
-        SEEN_SKILLS="${SEEN_SKILLS}|${skill_name}|"
-
-        if [ -f "$skill_file" ]; then
-          # 출처 표시
-          if [ "$search_dir" = "$PROJECT_CLAUDE_DIR" ]; then
-            display_path=".claude/skills/$skill_name/SKILL.md"
-          else
-            display_path="~/.claude/skills/$skill_name/SKILL.md"
-          fi
-          echo "**[$skill_name]** \`$display_path\`"
-          echo '```yaml'
-          head -6 "$skill_file"
-          echo '```'
-          echo ""
-        fi
-      fi
-    done
-  fi
-done
-
-cat << 'EOF'
-
-Skill 규칙을 준수하여 작업을 시작하세요.
-
----
-
-REPORT FORMAT PROTOCOL (작업 완료 시 필수)
-
-작업 완료 후 반드시 아래 3가지를 구조화하여 보고하세요:
-
-1. **Discoveries** — 발견한 것 (탐색 결과, 패턴, 참고 코드)
-2. **Changes** — 변경한 것 (수정/생성/삭제한 파일과 내용 요약)
-3. **Reasoning** — 판단 근거 (왜 그렇게 결정했는지, 검토한 대안)
-
-해당 없는 항목은 "해당 없음"으로 표시하세요.
-상세 형식은 ~/.claude/skills/Reporting/SKILL.md를 참조하세요.
-EOF