jun-claude-code 0.4.1 → 0.4.3

package/package.json

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

package/templates/global/CLAUDE.md

@@ -10,8 +10,8 @@ Main Agent의 Context Window는 제한적입니다. Subagent가 할 수 있는
 
 | 작업 | 전담 Agent | 참조 Skill |
 |------|-----------|-----------|
-| 코드베이스 탐색/검색 | `explore` | - |
-| 여러 파일 읽기 | `explore`, `context-collector` | - |
+| 파일 위치 찾기 (Glob/Grep) | `explore` | - |
+| 파일 내용 분석/여러 파일 읽기 | `context-collector` | - |
 | .claude/context/ 문서 수집 | `project-context-collector` | - |
 | 코드 패턴/구조 파악 | `context-collector` | - |
 | 복잡한 계획 수립 | `task-planner` | - |
@@ -66,13 +66,15 @@ Execution Plan에 skill이 없는 경우:
 ## 작업 워크플로우
 
 ```
-1. Context 수집 → 2. TaskList 생성 → 3. Agent/Skill 할당 (task-enricher) → 4. 수정 계획 (사용자 Confirm 필수)
+1. Context 수집 → 2. TaskList 생성 → 3. Agent/Skill 할당 (task-enricher) → 4. 수정 계획
                                                                                       ↓
-                                          5. 사이드이펙트 검증 (Code Flow, UserFlow, Breaking Change)
+                                          4.5. Plan 문서 생성 (.claude/plan/) → 5. 사용자 Confirm
                                                                                       ↓
-                                          6. 코드 수정 (Execution Plan에 따라 subagent 조율) → 7. 단위별 커밋
+                                          6. 사이드이펙트 검증 (Code Flow, UserFlow, Breaking Change)
                                                                                       ↓
-                                          8. Self Code Review (lint) → 9. Task 완료 검증
+                                          7. 코드 수정 (Execution Plan에 따라 subagent 조율) → 8. 단위별 커밋
+                                                                                      ↓
+                                          9. Self Code Review (lint) → 10. Task 완료 검증
 ```
 
 </workflow>
@@ -87,5 +89,6 @@ Execution Plan에 skill이 없는 경우:
 | 공통 코딩 원칙 | `.claude/skills/Coding/SKILL.md` |
 | Git 규칙 | `.claude/skills/Git/SKILL.md` |
 | 문서 작성 가이드 | `.claude/skills/Documentation/SKILL.md` |
+| 현재 작업 계획 | `.claude/plan/` (plan.md, context.md, checklist.md) |
 
 </reference>

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

@@ -1,6 +1,6 @@
 ---
 name: context-collector
-description: 실제 소스 코드에서 패턴/구현 방식/도메인 지식을 수집. Skill/Agent 식별, 코드 DEEP 탐색 전문.
+description: 소스 코드에서 패턴/구현 방식/도메인 지식을 수집. 파일 내용 분석/정리, Skill/Agent 식별, 코드 DEEP 탐색 전문.
 keywords: [코드탐색, 패턴파악, Skill식별, 도메인지식, 아키텍처분석, DEEP탐색, 소스코드]
 model: opus
 color: blue

package/templates/global/agents/explore.md

@@ -1,6 +1,6 @@
 ---
 name: explore
-description: 파일 위치/코드 검색이 필요할 때 호출. Glob/Grep으로 빠른 탐색, 파일 구조 파악.
+description: 파일 위치/코드 검색이 필요할 때 호출. Glob/Grep으로 빠른 탐색, 파일 구조 파악. 내용 분석/정리는 context-collector 사용.
 keywords: [탐색, 검색, 파일찾기, 패턴매칭, 구조파악, Glob, Grep, 빠른검색]
 model: haiku
 color: gray
@@ -16,6 +16,7 @@ color: gray
 2. **키워드 검색**: Grep으로 특정 코드/텍스트 검색
 3. **구조 파악**: 디렉토리 구조, 모듈 구성 파악
 4. **빠른 응답**: 깊은 분석 없이 위치/패턴만 찾기
+5. **범위 제한**: 파일 위치와 패턴만 찾기 — 내용 분석/요약/정리는 context-collector가 담당
 
 </role>
 
@@ -48,8 +49,10 @@ color: gray
 - 모듈 구조/아키텍처 개요 파악
 ```
 
-**context-collector** (소스 코드 DEEP 탐색):
+**context-collector** (내용 분석/정리 + 소스 코드 DEEP 탐색):
 ```
+- 파일 내용을 읽고 전반적으로 파악/정리
+- 여러 파일의 내용을 분석하여 요약
 - 깊은 코드 분석 필요
 - 여러 파일 간 관계 파악
 - Skill/Agent 식별

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

@@ -82,4 +82,17 @@ done
 cat << 'EOF'
 
 Skill 규칙을 준수하여 작업을 시작하세요.
+
+---
+
+REPORT FORMAT PROTOCOL (작업 완료 시 필수)
+
+작업 완료 후 반드시 아래 3가지를 구조화하여 보고하세요:
+
+1. **Discoveries** — 발견한 것 (탐색 결과, 패턴, 참고 코드)
+2. **Changes** — 변경한 것 (수정/생성/삭제한 파일과 내용 요약)
+3. **Reasoning** — 판단 근거 (왜 그렇게 결정했는지, 검토한 대안)
+
+해당 없는 항목은 "해당 없음"으로 표시하세요.
+상세 형식은 ~/.claude/skills/Reporting/SKILL.md를 참조하세요.
 EOF

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

@@ -40,10 +40,10 @@ Main Agent의 Context Window는 제한적입니다.
 
 | 작업 | 전담 Agent |
 |------|-----------|
-| 파일 탐색 (Glob/Grep) | explore Agent가 전담 |
+| 파일 위치 탐색 (Glob/Grep) | explore Agent가 전담 |
 | .claude/context/ 문서 탐색 | project-context-collector가 전담 |
 | 소스 코드 패턴/구조 파악 | context-collector가 전담 |
-| 2개 이상 파일 읽기 | explore/context-collector가 전담 |
+| 파일 내용 분석/여러 파일 읽기 | context-collector가 전담 |
 | 복잡한 분석/계획 | task-planner에 위임 |
 | 파일 수정 (3개 이상) | code-writer가 전담 |
 | Git 명령어 실행 (git add, commit, push 등) | git-manager에 위임 |

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

@@ -78,6 +78,17 @@ Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희
 복잡한 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 -- 필수
 
 - [ ] 계획을 사용자에게 보여주고 승인받은 후 구현 진행
@@ -152,7 +163,7 @@ Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희
 
 ### 워크플로우 요약
 
-계획(목적확인->Context->TaskList->Agent/Skill할당->수정계획->Plan검증(선택)->Confirm) -> 검증(사이드이펙트) -> 구현(코드수정->커밋) -> 리뷰(CodeReview->완료검증)
+계획(목적확인->Context->TaskList->Agent/Skill할당->수정계획->Plan검증(선택)->Plan문서생성->Confirm) -> 검증(사이드이펙트) -> 구현(코드수정->커밋) -> 리뷰(CodeReview->완료검증)
 
 ### 참조 가능한 Skills (자동 탐색됨)
 

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

@@ -0,0 +1,111 @@
+---
+name: Reporting
+description: Subagent 보고 형식 가이드. Discoveries/Changes/Reasoning 3축 구조화, Agent 유형별 출력 템플릿 제공.
+keywords: [보고, 리포트, Discoveries, Changes, Reasoning, subagent, 출력형식]
+estimated_tokens: ~600
+---
+
+# Subagent 보고 형식
+
+<rules>
+
+## 보고 3축
+
+모든 Subagent 보고는 다음 3축으로 구조화한다.
+
+| 축 | 의미 | 포함 내용 |
+|----|------|----------|
+| **Discoveries** | 발견한 것 | 탐색 결과, 패턴, 참고 코드, 기존 구현 방식 |
+| **Changes** | 변경한 것 | 수정/생성/삭제한 파일과 내용 요약 |
+| **Reasoning** | 판단 근거 | 결정 이유, 검토한 대안, 트레이드오프 |
+
+</rules>
+
+<instructions>
+
+## Agent 유형별 가이드
+
+Agent 유형에 따라 집중하는 축이 다르다.
+
+| 유형 | 대표 Agent | 주력 축 |
+|------|-----------|---------|
+| 탐색형 | explore, context-collector, impact-analyzer | Discoveries 중심 |
+| 수정형 | code-writer, simple-code-writer | Changes + Reasoning 중심 |
+| 검증형 | code-reviewer, qa-tester | Discoveries + Reasoning 중심 |
+| 관리형 | git-manager, context-manager | Changes 중심 |
+
+## 작성 원칙
+
+| 원칙 | 실행 방법 |
+|------|----------|
+| 간결하게 작성 | 핵심 사실만 기술, 서사 제외 |
+| 상대 경로 사용 | 파일 경로는 프로젝트 루트 기준으로 표기 |
+| 변경 내역 명시 | 코드 변경 시 before/after 또는 diff 요약 포함 |
+| 대안 근거 포함 | 검토한 대안이 있으면 기각 이유를 Reasoning에 기술 |
+| 빈 축 표기 | 해당 없는 축은 "해당 없음"으로 표시 |
+
+</instructions>
+
+<output_format>
+
+## 출력 템플릿
+
+### 탐색형 (Discoveries 중심)
+
+```markdown
+## Discoveries
+- [발견 1]: 설명
+- [발견 2]: 설명
+
+## Changes
+해당 없음
+
+## Reasoning
+- [판단]: 근거
+```
+
+### 수정형 (Changes + Reasoning 중심)
+
+```markdown
+## Discoveries
+- 참고한 기존 패턴: `path/to/reference.ts`
+
+## Changes
+| 파일 | 변경 유형 | 요약 |
+|------|----------|------|
+| `path/to/file.ts` | 수정 | before/after 또는 diff 요약 |
+| `path/to/new.ts` | 생성 | 파일 목적 설명 |
+
+## Reasoning
+- [결정 사항]: 근거, 검토한 대안, 기각 이유
+```
+
+### 검증형 (Discoveries + Reasoning 중심)
+
+```markdown
+## Discoveries
+- [이슈 1]: severity (critical/warning/info) - 설명
+- [이슈 2]: severity - 설명
+
+## Changes
+해당 없음
+
+## Reasoning
+- [이슈 1 판단]: 문제 원인, 권장 수정 방향
+```
+
+### 관리형 (Changes 중심)
+
+```markdown
+## Discoveries
+해당 없음
+
+## Changes
+- [작업 1]: 결과 요약
+- [작업 2]: 결과 요약
+
+## Reasoning
+해당 없음
+```
+
+</output_format>