muno-claude-plugin 1.14.0 → 1.14.1

package/bin/cli.js

@@ -3,7 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 
-const VERSION = '1.14.0';
+const VERSION = '1.14.1';
 const PACKAGE_NAME = 'muno-claude-plugin';
 
 // ANSI colors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muno-claude-plugin",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "description": "Unleash Claude Code's full power - Complete development workflow with expert personas, TDD-based agents, and automated documentation",
   "main": "bin/cli.js",
   "bin": {

package/templates/skills/epic-generator/SKILL.md

@@ -0,0 +1,458 @@
+---
+name: epic-generator
+description: |
+  Creates Epic documents from PRD (Product Requirements Document) by analyzing requirements
+  and designing Epic-level feature sets. Use when user requests "create epic", "에픽 만들어",
+  "PRD to epic", "epic from PRD", "break down PRD to epics", "PRD 분해", "백로그 만들어",
+  or needs to define large feature sets that span 2-8 weeks. Epic represents business-oriented
+  feature groupings with measurable success metrics and clear scope definition.
+allowed-tools: Read, Write, Edit, Glob, Grep, WebSearch, WebFetch
+---
+
+# Epic Generator
+
+PRD를 **실행 가능한 Epic**으로 변환합니다.
+
+## 페르소나
+
+@.claude/personas/po.md
+
+---
+
+## 개요
+
+Epic은 **비즈니스 목표를 달성하기 위한 대규모 기능 묶음**입니다.
+
+**핵심**: 추측 금지. PRD 정보 부족 시 질문.
+
+---
+
+## 문서 체계
+
+```
+PRD (What & Why)
+     │
+     ▼
+┌─────────────────────────────────────────┐
+│            Epic (이 스킬)                │
+├─────────────────────────────────────────┤
+│  • 비즈니스 목표 정의                     │
+│  • 범위 설정 (In/Out-of-Scope)           │
+│  • 성공 지표 (측정 가능)                  │
+│  • Story 목록 (개요만)                   │
+└─────────────────────────────────────────┘
+     │
+     ▼
+Story (story-generator) → HLD → LLD → Task → Code
+```
+
+---
+
+## Epic 정의
+
+| 항목 | 설명 |
+|------|------|
+| **크기** | 2-8주 (여러 스프린트) |
+| **관점** | 비즈니스 목표/기능 묶음 |
+| **완료조건** | 하위 Story 모두 완료 + 성공 지표 달성 |
+| **예시** | "사용자 인증 시스템", "결제 통합" |
+
+**Story와의 차이**:
+- Epic: "사용자 인증 시스템 구축" (2-8주, 여러 Story 포함)
+- Story: "이메일로 로그인할 수 있다" (1-5일, 1 스프린트 내)
+
+---
+
+## 워크플로우
+
+```mermaid
+flowchart TD
+    A[사용자 요청] --> B{PRD 존재?}
+    B -->|No| C[PRD 작성 권유]
+    B -->|Yes| D[Step 1: PRD 분석]
+    D --> E[Step 2: Epic 구조 설계]
+    E --> F{Epic 승인?}
+    F -->|No| G[수정 요청]
+    G --> E
+    F -->|Yes| H[Step 3: Epic 문서 작성]
+    H --> I[Step 4: 저장]
+    I --> J[Step 5: Subagent 체인]
+    J --> K[Epic 완성]
+```
+
+---
+
+## Step 0: PRD 확인
+
+PRD가 없으면 먼저 작성하도록 안내합니다.
+
+```
+Epic 작성을 위해 PRD(Product Requirements Document)가 필요합니다.
+PRD가 준비되어 있으신가요? 없다면 먼저 PRD를 작성해주세요.
+(prd-generator 스킬을 사용하시면 도움이 됩니다)
+```
+
+**PRD에서 추출할 정보**:
+- Background & Problem (문제 정의)
+- Objectives & Success Metrics (목표 및 성공 지표)
+- Target Users (타겟 사용자)
+- Key Features (핵심 기능 목록)
+- Scope (In/Out-of-Scope)
+- Constraints (제약 조건)
+
+---
+
+## Step 1: PRD 분석
+
+### 수집해야 할 정보
+
+- PRD의 핵심 기능(Key Features) 목록
+- 비즈니스 목표 및 성공 지표
+- 타겟 사용자 페르소나
+- 제약 조건 및 우선순위
+
+### 질문 예시 (한 번에 2-3개만)
+
+```
+PRD를 확인했습니다. Epic 설계를 위해 몇 가지 확인이 필요합니다.
+
+1. 가장 우선순위가 높은 기능 그룹은 무엇인가요? (MVP 범위)
+   → 왜: Epic 우선순위 결정
+
+2. 각 Epic의 예상 완료 기간은 몇 스프린트로 보시나요?
+   → 왜: Epic 크기 조정 (2-8주 권장)
+
+3. Epic 간 의존성이 있나요? (순서가 중요한 Epic)
+   → 왜: Epic 실행 순서 결정
+```
+
+### 정보 수집 완료 기준
+
+- [ ] PRD의 핵심 기능이 파악됨
+- [ ] 비즈니스 목표가 명확함
+- [ ] 우선순위가 결정됨
+- [ ] Epic 간 의존성이 식별됨
+
+**모두 확인되면 Step 2 진행**
+
+---
+
+## Step 2: Epic 구조 설계
+
+### Epic 설계 원칙
+
+1. **비즈니스 가치 중심**: 기술이 아닌 사용자/비즈니스 관점
+2. **독립성**: 다른 Epic과 최소 의존성
+3. **측정 가능**: 성공 지표가 명확 (Before → After)
+4. **적정 크기**: 2-8주 내 완료 가능
+
+### Epic 설계 시 고려사항
+
+```markdown
+## Epic 분해 기준
+
+### ✅ Good Epic
+- "사용자 인증 시스템" (이메일/소셜 로그인, 비밀번호 재설정 포함)
+- "상품 검색 및 필터링" (검색, 카테고리, 필터, 정렬 포함)
+
+### ❌ Bad Epic
+- "백엔드 API 개발" → 기술 중심, 사용자 가치 불명확
+- "UI 개선" → 범위 모호, 측정 불가
+```
+
+### 질문 예시 (Epic 확정 전)
+
+```
+Epic 구조안을 검토해주세요.
+
+1. Epic 간 우선순위가 적절한가요? (MVP에 필수적인 Epic이 먼저인가?)
+   → 왜: 개발 순서 최적화
+
+2. Epic 크기가 적절한가요? (너무 크거나 작은 Epic은 없나요?)
+   → 왜: 2-8주 크기 유지
+
+3. 빠진 기능이나 추가해야 할 Epic이 있나요?
+   → 왜: PRD 완전성 확인
+```
+
+### Epic 구조 템플릿 (간략 버전)
+
+```markdown
+## Epic 개요
+
+| Epic ID | 제목 | 비즈니스 목표 | 예상 기간 | 우선순위 |
+|---------|------|--------------|----------|----------|
+| EPIC-001 | [제목] | [목표] | N 스프린트 | Must |
+| EPIC-002 | [제목] | [목표] | M 스프린트 | Should |
+
+**성공 지표 예시**:
+- EPIC-001: 로그인 성공률 95% 이상
+- EPIC-002: 검색 응답 시간 2초 이내
+```
+
+---
+
+## Step 3: Epic 문서 작성
+
+### 작성 원칙
+
+1. **템플릿 기반**: [epic-template.md](reference/epic-template.md) 사용
+2. **명확한 범위**: In/Out-of-Scope 반드시 명시
+3. **측정 가능한 성공 지표**: Before → After 형식
+4. **Story 개요만**: 상세 Story는 story-generator에서 작성
+
+### Epic 문서 구조
+
+```markdown
+# Epic: [기능명]
+
+## 문서 정보
+- **PRD**: documents/prd/{기능명}-prd.md
+- **상태**: Draft / Review / Approved
+- **우선순위**: Must / Should / Could
+
+## 비즈니스 목표
+[이 Epic이 달성하려는 비즈니스 가치]
+
+## 범위
+
+### ✅ In-Scope
+- [포함 기능 1]
+- [포함 기능 2]
+
+### ❌ Out-of-Scope
+- [제외 기능] - 이유: [이유]
+
+## 성공 지표
+
+| 지표 | 현재 (Before) | 목표 (After) | 측정 방법 |
+|------|---------------|--------------|-----------|
+| [지표 1] | [현재값] | [목표값] | [방법] |
+
+## Story 목록 (개요)
+
+| Story ID | 제목 | 크기 | 상태 |
+|----------|------|------|------|
+| STORY-001 | [제목] | M | Not Started |
+| STORY-002 | [제목] | S | Not Started |
+
+**총 Story Points**: X SP
+
+## 우선순위
+
+| 우선순위 | Story |
+|----------|-------|
+| Must Have | STORY-001, 002 |
+| Should Have | STORY-005 |
+
+## 의존성
+
+### 선행 Epic
+- [없음 / EPIC-XXX: 이유]
+
+### 외부 의존성
+- [없음 / 외부 API, 타 팀 작업 등]
+
+## 스프린트 배분 제안
+
+### Sprint 1
+- STORY-001: [제목] (3 SP)
+- STORY-002: [제목] (5 SP)
+
+### Sprint 2
+- STORY-003: [제목] (5 SP)
+```
+
+**참고**: 상세 템플릿은 [reference/epic-template.md](reference/epic-template.md) 참조
+
+---
+
+## Step 4: 저장
+
+### 파일 경로
+
+```
+documents/epics/{epic-name}/epic.md
+```
+
+**예시**:
+- `documents/epics/user-authentication/epic.md`
+- `documents/epics/payment-integration/epic.md`
+
+### 파일명 규칙
+
+- Epic 폴더: `{epic-name}` (소문자 + 하이픈)
+- Epic 파일: `epic.md` (소문자 고정)
+
+### 저장 전 체크리스트
+
+- [ ] 경로가 올바른가? (`documents/epics/{epic-name}/epic.md`)
+- [ ] 파일명이 소문자인가? (`epic.md`)
+- [ ] 비즈니스 목표가 명확한가?
+- [ ] 성공 지표가 측정 가능한가?
+- [ ] In/Out-of-Scope가 명시되었는가?
+- [ ] Story 목록이 포함되었는가? (개요만)
+- [ ] 우선순위가 설정되었는가?
+
+---
+
+## Step 5: Subagent 체인 호출
+
+**중요: Epic 파일 저장이 완료되면 반드시 다음 Subagent 체인을 순서대로 실행합니다:**
+
+### Step 1: 품질 검토 (필수)
+
+**Subagent**: `epic-reviewer`
+
+Task 도구를 사용하여 다음과 같이 호출합니다:
+
+```
+Task 도구 호출:
+- subagent_type: epic-reviewer
+- prompt: "다음 Epic 문서를 검토해주세요: documents/epics/{epic-name}/epic.md"
+```
+
+**다음 단계 조건**:
+- ✅ 리뷰 통과 → Step 2로 진행
+- ❌ 리뷰 실패 → 피드백 반영 후 다시 Step 1
+
+### Step 2: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+리뷰 통과 후, Task 도구를 사용하여 상태를 동기화합니다:
+
+```
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "Epic 문서가 생성되었습니다. 상태를 추적해주세요: documents/epics/{epic-name}/epic.md"
+```
+
+### Step 3: 사용자 최종 확인
+
+- 리뷰 및 상태 추적 완료 후 사용자에게 최종 검토 요청
+
+---
+
+## 금지 사항
+
+### 절대 하지 말 것
+
+1. **PRD 없이 Epic 작성 금지**
+   ```
+   ❌ "사용자 인증 에픽 만들어줘" → 바로 작성
+   ✅ "PRD가 있나요?" → PRD 분석 후 작성
+   ```
+
+2. **추측으로 Epic 작성 금지**
+   ```
+   ❌ "아마도 이런 기능이 필요할 거야" → 추측
+   ✅ "다음 정보가 필요합니다: ..." → 질문
+   ```
+
+3. **기술 중심 Epic 금지**
+   ```
+   ❌ "Redis 캐시 시스템 구축"
+   ✅ "사용자가 빠른 응답 속도를 경험할 수 있다"
+   ```
+
+4. **측정 불가능한 성공 지표 금지**
+   ```
+   ❌ "사용자가 만족해야 함"
+   ✅ "로그인 성공률 95% 이상"
+   ```
+
+5. **모호한 범위 금지**
+   ```
+   ❌ "로그인 관련 기능 모두"
+   ✅ In-Scope: 이메일 로그인, 소셜 로그인
+       Out-of-Scope: 2FA (이유: v2.0에서 구현)
+   ```
+
+---
+
+## Good/Bad 예시
+
+### Epic 제목
+
+```markdown
+# ✅ Good
+## Epic: 사용자 인증 시스템
+
+**비즈니스 목표**: 사용자가 안전하게 서비스에 접근하여 개인화된 경험을 받을 수 있다
+
+**성공 지표**:
+- 로그인 성공률: 95% 이상
+- 비정상 로그인 차단율: 99% 이상
+
+# ❌ Bad
+## Epic: 로그인 만들기
+
+→ 비즈니스 가치 없음, 성공 지표 없음, 기술 중심
+```
+
+### 범위 정의
+
+```markdown
+# ✅ Good
+**In-Scope**:
+- 이메일 + 비밀번호 로그인
+- Google OAuth 로그인
+- 비밀번호 재설정
+
+**Out-of-Scope**:
+- Apple 로그인 - 이유: iOS 앱 출시 후 (v2.0)
+- 2FA - 이유: 보안 요구사항 정의 필요
+
+# ❌ Bad
+**범위**: 로그인 관련 모든 기능
+
+→ 경계 불명확, Out-of-Scope 없음
+```
+
+### 성공 지표
+
+```markdown
+# ✅ Good
+| 지표 | 현재 | 목표 | 측정 |
+|------|------|------|------|
+| 로그인 성공률 | 신규 | 95%+ | Auth 로그 |
+| 로그인 시간 | 신규 | 3초 이내 | 성능 모니터링 |
+
+# ❌ Bad
+- 로그인이 잘 되어야 함
+- 사용자가 만족해야 함
+
+→ 측정 불가, 정량화 없음
+```
+
+---
+
+## 체크리스트
+
+### Epic 작성 완료 확인
+
+- [ ] 비즈니스 목표가 사용자 관점인가?
+- [ ] 성공 지표가 측정 가능한가? (Before → After)
+- [ ] In/Out-of-Scope가 명확한가?
+- [ ] 2-8주 내 완료 가능한 크기인가?
+- [ ] Story 목록(개요)이 있는가?
+- [ ] 우선순위가 설정되었는가?
+- [ ] 의존성이 명시되어 있는가?
+
+---
+
+## 참고 자료
+
+**템플릿**: [epic-template.md](reference/epic-template.md)
+**원칙**: [epic-principles.md](reference/epic-principles.md)
+
+---
+
+## 관련 스킬
+
+- `prd-generator`: PRD 생성 (Epic 작성 전 필수)
+- `story-generator`: Story 생성 (Epic 완성 후)
+- `hld-generator`: HLD 생성 (설계 단계)
+- `lld-generator`: LLD 생성 (상세 설계)
+- `task-generator`: Task 생성 (구현 단계)