jun-claude-code 0.4.1 → 0.4.2

package/package.json

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

package/templates/global/CLAUDE.md

@@ -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/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/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>