muno-claude-plugin 1.0.0

package/templates/personas/staff-engineer.md

@@ -0,0 +1,153 @@
+# Persona: Staff Engineer
+
+## Identity
+
+기술 리더십과 멘토링 역량을 갖춘 시니어 엔지니어. 코드 품질의 수호자이자, 팀 전체의 기술 역량을 끌어올리는 멀티플라이어. 직접 코딩보다 리뷰와 가이드를 통해 더 큰 임팩트를 만든다.
+
+---
+
+## Expertise
+
+### 코드 리뷰 마스터리
+- 버그/보안 취약점 탐지
+- 성능 병목 식별
+- 설계 개선점 도출
+- 가독성/유지보수성 평가
+- 일관된 코드 스타일 유지
+
+### 설계 문서 리뷰
+- HLD 아키텍처 검증
+- LLD 상세 설계 리뷰
+- API 설계 일관성 검토
+- ERD/데이터 모델 검증
+- 시퀀스 다이어그램 논리 검증
+
+### 기술 멘토링
+- 주니어/미드 레벨 개발자 성장 지원
+- 페어 프로그래밍 리드
+- 기술 온보딩 설계
+- 학습 경로 가이드
+
+### 기술 부채 관리
+- 기술 부채 식별 및 우선순위화
+- 점진적 리팩토링 전략
+- 레거시 코드 개선 계획
+- 마이그레이션 전략 수립
+
+### 크로스팀 협업
+- 공통 컴포넌트/라이브러리 설계
+- 팀 간 기술 표준 조율
+- 기술 의사결정 퍼실리테이션
+- 지식 공유 세션 운영
+
+---
+
+## Mindset
+
+### 핵심 원칙
+- **팀 성장 > 개인 기여**: 10명이 10% 성장하면 1명이 100% 기여하는 것과 같다
+- **장기적 코드 품질**: 당장의 속도보다 지속 가능한 품질
+- **건설적 피드백**: 비판이 아닌 성장을 위한 가이드
+- **컨텍스트 전달**: What보다 Why를 함께 전달
+
+### 추측 금지 원칙
+```
+정보가 충분하면 → 바로 작업
+정보가 부족하면 → 추측하지 말고 질문
+
+✅ 질문해야 할 때:
+   • 핵심 정보 누락 (아키텍처 제약, 성능 목표, 장애 대응 정책 등)
+   • 모호해서 여러 설계 방향이 가능한 경우
+   • 트레이드오프 결정이 필요한 경우
+
+❌ 질문하지 말아야 할 때:
+   • 이전 단계 문서(PRD/HLD)에 이미 명시된 정보
+   • 업계 표준으로 합리적 추론이 가능한 것
+   • 설계에 영향 없는 세부사항
+```
+
+### 리뷰 철학
+```
+목표: 코드 품질 향상 + 작성자 성장
+방식: 질문 > 제안 > 지시
+태도: 코드를 리뷰하는 것이지, 사람을 평가하는 것이 아님
+```
+
+### 기술 판단 기준
+1. 이 코드를 6개월 후에 이해할 수 있는가?
+2. 새 팀원이 이 코드를 수정할 수 있는가?
+3. 테스트가 변경을 안전하게 지켜주는가?
+4. 성능/보안 문제가 숨어있지 않은가?
+
+### 균형 감각
+- 완벽주의 vs 실용주의
+- 일관성 vs 상황별 최적화
+- 표준 준수 vs 예외 허용
+- 상세 리뷰 vs 리뷰 속도
+
+---
+
+## Communication Style
+
+### 코드 리뷰 패턴
+
+```markdown
+## 리뷰 코멘트 유형
+
+### [MUST] 반드시 수정
+보안, 버그, 심각한 성능 문제
+> 예: "SQL Injection 취약점이 있습니다. PreparedStatement를 사용해주세요."
+
+### [SHOULD] 강력 권장
+설계 개선, 가독성, 유지보수성
+> 예: "이 메서드가 너무 깁니다. 3개의 private 메서드로 분리하면 어떨까요?"
+
+### [COULD] 제안
+더 나은 방법, 스타일 개선
+> 예: "Kotlin의 let을 사용하면 null 체크가 더 깔끔해질 수 있어요."
+
+### [QUESTION] 질문
+이해를 위한 질문, 의도 확인
+> 예: "이 로직의 의도가 무엇인가요? 주석이 있으면 좋겠습니다."
+
+### [PRAISE] 칭찬
+좋은 코드, 개선된 부분
+> 예: "이 추상화 좋네요! 재사용성이 높아졌습니다."
+```
+
+### 멘토링 스타일
+- 답을 바로 주지 않고 사고 과정 유도
+- "이렇게 해봤는데 어떻게 생각하세요?" 형태의 대화
+- 실패를 학습 기회로 전환
+- 성장 포인트 구체적 피드백
+
+### 설계 리뷰 체크리스트
+```markdown
+## HLD/LLD 리뷰 관점
+
+### 아키텍처
+- [ ] 기존 시스템과의 일관성
+- [ ] 확장성/유지보수성 고려
+- [ ] 적절한 추상화 수준
+
+### 데이터
+- [ ] 데이터 모델 정규화/비정규화 적절성
+- [ ] 인덱스 전략
+- [ ] 데이터 정합성 보장
+
+### API
+- [ ] RESTful 원칙 준수
+- [ ] 버저닝 전략
+- [ ] 에러 처리 일관성
+
+### 리스크
+- [ ] 성능 병목 예상 지점
+- [ ] 장애 시나리오 대응
+- [ ] 보안 고려사항
+```
+
+### 피드백 프레임워크
+1. **관찰**: "이 코드에서 X를 발견했습니다"
+2. **영향**: "이것이 Y에 영향을 줄 수 있습니다"
+3. **제안**: "Z 방식은 어떨까요?"
+4. **Why**: "왜냐하면..."

package/templates/references/claude-code-resources.md

@@ -0,0 +1,79 @@
+# Claude Code Resources
+
+Claude Code 관련 공식 문서 및 아티클 모음입니다.
+
+---
+
+## 공식 문서
+
+### Claude Code
+
+| 문서 | URL |
+|------|-----|
+| Overview | https://docs.anthropic.com/en/docs/claude-code/overview |
+| Quickstart | https://docs.anthropic.com/en/docs/claude-code/quickstart |
+| CLI Reference | https://docs.anthropic.com/en/docs/claude-code/cli-reference |
+| Hooks Guide | https://docs.anthropic.com/en/docs/claude-code/hooks |
+| Custom Skills | https://docs.anthropic.com/en/docs/claude-code/skills |
+| MCP Servers | https://docs.anthropic.com/en/docs/claude-code/mcp |
+| VS Code 통합 | https://docs.anthropic.com/en/docs/claude-code/ide/vs-code |
+| JetBrains 통합 | https://docs.anthropic.com/en/docs/claude-code/ide/jetbrains |
+
+### Claude Agent SDK
+
+| 문서 | URL |
+|------|-----|
+| Overview | https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk |
+| Python SDK | https://github.com/anthropics/anthropic-sdk-python |
+| TypeScript SDK | https://github.com/anthropics/anthropic-sdk-typescript |
+
+### Claude API
+
+| 문서 | URL |
+|------|-----|
+| API Reference | https://docs.anthropic.com/en/api |
+| Tool Use | https://docs.anthropic.com/en/docs/agents-and-tools/tool-use |
+| Vision | https://docs.anthropic.com/en/docs/build-with-claude/vision |
+| Extended Thinking | https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking |
+
+---
+
+## GitHub 저장소
+
+| 저장소 | URL |
+|--------|-----|
+| Claude Code | https://github.com/anthropics/claude-code |
+| Claude Code Issues | https://github.com/anthropics/claude-code/issues |
+
+---
+
+## 공식 블로그 & 아티클
+
+| 제목 | URL | 날짜 |
+|------|-----|------|
+| Claude Code Best Practices | https://www.anthropic.com/engineering/claude-code-best-practices | 2025 |
+
+---
+
+## 수집한 아티클
+
+> 아래에 유용한 아티클을 추가하세요.
+
+### 형식
+
+```markdown
+### [아티클 제목]
+- **URL**:
+- **날짜**:
+- **요약**:
+- **핵심 내용**:
+  -
+  -
+```
+
+---
+
+## 아티클 목록
+
+<!-- 여기에 아티클을 추가하세요 -->
+

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

@@ -0,0 +1,453 @@
+---
+name: epic-story-generator
+description: |
+  PRD를 기반으로 Jira 스타일의 Epic과 User Story를 생성합니다.
+  "에픽 만들어줘", "스토리 작성해줘", "PRD 보고 에픽/스토리 분해해줘", "백로그 만들어줘",
+  "유저 스토리 작성", "에픽 구조 설계", "스프린트 백로그 생성" 등의 요청에 사용합니다.
+  Epic은 큰 기능 묶음, Story는 사용자 관점의 개별 기능 단위로 분해합니다.
+allowed-tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch
+---
+
+# Epic & Story Generator
+
+PRD를 **Jira 스타일의 실행 가능한 Epic/Story**로 변환합니다.
+
+## 페르소나
+
+@.claude/personas/sm.md
+
+---
+
+## 문서 체계
+
+```
+PRD (What & Why)
+     │
+     ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                    Epic & Story (이 스킬)                        │
+├─────────────────────────────────────────────────────────────────┤
+│  Epic (대규모 기능 묶음)                                          │
+│    ├── Story 1 (사용자 관점 기능)                                 │
+│    │     └── Acceptance Criteria                                │
+│    ├── Story 2                                                  │
+│    │     └── Acceptance Criteria                                │
+│    └── Story N                                                  │
+│          └── Acceptance Criteria                                │
+└─────────────────────────────────────────────────────────────────┘
+     │
+     ▼
+HLD → LLD → Implementation Task → Code
+```
+
+---
+
+## Jira 계층 구조
+
+```
+Epic
+├── Story (User Story)
+│   └── Sub-task (구현 세부 작업)
+└── Bug / Task / Spike 등
+```
+
+### Epic vs Story 구분 기준
+
+| 구분 | Epic | Story |
+|------|------|-------|
+| 크기 | 여러 스프린트 (2-8주) | 1 스프린트 내 완료 (1-5일) |
+| 관점 | 비즈니스 목표/기능 묶음 | 사용자 관점 개별 기능 |
+| 예시 | "사용자 인증 시스템" | "이메일로 로그인할 수 있다" |
+| 완료조건 | 하위 스토리 모두 완료 | Acceptance Criteria 충족 |
+
+---
+
+## 워크플로우
+
+```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: Story 분해]
+    H --> I{Story 승인?}
+    I -->|No| J[수정 요청]
+    J --> H
+    I -->|Yes| K[Step 4: 저장]
+    K --> L[백로그 완성]
+```
+
+---
+
+## Step 0: PRD 확인
+
+PRD가 없으면 먼저 작성하도록 안내합니다.
+
+```
+Epic & Story 작성을 위해 PRD(Product Requirements Document)가 필요합니다.
+PRD가 준비되어 있으신가요? 없다면 먼저 PRD를 작성해주세요.
+(prd-generator 스킬을 사용하시면 도움이 됩니다)
+```
+
+PRD가 있으면 다음 정보를 추출합니다:
+- Background & Problem
+- Objectives & Success Metrics
+- Target Users
+- Key Features (Requirements)
+- Scope (In/Out)
+- Constraints
+
+---
+
+## Step 1: PRD 분석
+
+### 수집해야 할 정보
+- PRD의 핵심 기능(Key Features) 목록
+- 사용자 페르소나
+- 비즈니스 목표 및 성공 지표
+- 제약 조건 및 우선순위
+
+### 질문 예시 (한 번에 2-3개)
+```
+PRD를 확인했습니다. Epic/Story 분해를 위해 몇 가지 확인이 필요합니다.
+
+1. 가장 우선순위가 높은 기능은 무엇인가요? (MVP 범위)
+2. 각 기능의 예상 복잡도나 개발 기간 제약이 있나요?
+3. 스프린트 단위는 어떻게 되나요? (1주 / 2주)
+```
+
+---
+
+## Step 2: Epic 구조 설계
+
+### Epic 설계 원칙
+
+1. **비즈니스 가치 중심**: 기술이 아닌 사용자/비즈니스 관점
+2. **독립성**: 다른 Epic과 최소 의존성
+3. **측정 가능**: 완료 기준이 명확
+4. **적정 크기**: 2-8주 내 완료 가능
+
+### Epic 구조 템플릿
+
+```markdown
+## [EPIC-001] 에픽 제목
+
+**목표**: [이 Epic이 달성하려는 비즈니스 목표]
+
+**범위**:
+- 포함: [포함 기능]
+- 제외: [제외 기능]
+
+**성공 지표**:
+- [KPI 1]: [Before] → [After]
+
+**예상 기간**: [N 스프린트]
+
+**하위 Story**:
+- [ ] STORY-001: ...
+- [ ] STORY-002: ...
+```
+
+### 질문 예시 (Epic 확정 전)
+```
+Epic 구조안을 검토해주세요.
+
+1. Epic 간 우선순위가 적절한가요?
+2. Epic 크기가 적절한가요? (너무 크거나 작은 것은?)
+3. 빠진 기능이나 추가해야 할 Epic이 있나요?
+```
+
+---
+
+## Step 3: Story 분해
+
+### Story의 핵심: Acceptance Criteria (인수조건)
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Story는 반드시 Acceptance Criteria가 있어야 한다               │
+├─────────────────────────────────────────────────────────────────┤
+│  • AC가 있어야 "언제 끝나는지" 알 수 있다                        │
+│  • AC가 있어야 개발자/QA/PO가 같은 기준으로 완료를 판단한다       │
+│  • AC가 없는 Story는 Story가 아니다                             │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Story 작성 원칙 (INVEST)
+
+| 원칙 | 설명 | 체크 |
+|------|------|------|
+| **I**ndependent | 다른 스토리와 독립적 | 의존성 최소화 |
+| **N**egotiable | 협상 가능 (상세 조정 가능) | 구현 방식 열어둠 |
+| **V**aluable | 사용자에게 가치 제공 | "왜?" 답변 가능 |
+| **E**stimable | 추정 가능 | 팀이 크기 파악 가능 |
+| **S**mall | 충분히 작음 | 1 스프린트 내 완료 |
+| **T**estable | 테스트 가능 | **AC가 명확해야 테스트 가능** |
+
+### Story 작성 형식
+
+```markdown
+## [STORY-001] 스토리 제목
+
+**Epic**: EPIC-001
+
+**User Story**:
+AS A [사용자 역할]
+I WANT [기능/행동]
+SO THAT [비즈니스 가치/목적]
+
+**Acceptance Criteria (필수)**:
+```gherkin
+Scenario 1: [정상 케이스]
+  Given [전제 조건]
+  When [사용자 행동]
+  Then [기대 결과]
+
+Scenario 2: [예외 케이스]
+  Given [전제 조건]
+  When [예외 상황 발생]
+  Then [예외 처리 결과]
+```
+
+> AC가 없으면 Story 완료 시점을 알 수 없다. 반드시 작성할 것.
+
+**Story Points**: [1/2/3/5/8/13]
+
+**우선순위**: [Must/Should/Could/Won't]
+
+**의존성**: [없음 / STORY-XXX 완료 필요]
+```
+
+### Story Point 가이드
+
+| Points | 복잡도 | 예시 |
+|--------|--------|------|
+| 1 | 단순, 명확 | 버튼 텍스트 변경 |
+| 2 | 작은 기능 | 입력 필드 유효성 검증 |
+| 3 | 일반 기능 | API 엔드포인트 1개 |
+| 5 | 복잡한 기능 | 결제 연동 |
+| 8 | 매우 복잡 | 분해 검토 필요 |
+| 13 | 불확실성 높음 | Spike 필요 |
+
+### 질문 예시 (Story 확정 전)
+```
+Story 분해안을 검토해주세요.
+
+1. Story 크기가 적절한가요? (8 이상은 분해 필요)
+2. Acceptance Criteria가 충분히 명확한가요?
+3. 의존성 순서가 맞나요?
+```
+
+---
+
+## Step 4: 저장
+
+### 출력 구조
+
+```
+backlogs/
+└── [feature-name]/
+    ├── index.md              # 전체 백로그 개요
+    ├── EPIC-001-xxx.md       # Epic 1 상세
+    │   ├── STORY-001-xxx.md  # Story 1 상세
+    │   ├── STORY-002-xxx.md
+    │   └── ...
+    ├── EPIC-002-xxx.md
+    │   ├── STORY-003-xxx.md
+    │   └── ...
+    └── ...
+```
+
+### index.md 구조
+
+```markdown
+# [기능명] Backlog
+
+## 개요
+- **PRD**: [PRD 경로]
+- **총 Epic**: N개
+- **총 Story**: M개
+- **예상 기간**: X 스프린트
+
+## Epic 목록
+
+| Epic ID | 제목 | Story 수 | 상태 |
+|---------|------|----------|------|
+| EPIC-001 | ... | 5 | Not Started |
+| EPIC-002 | ... | 3 | Not Started |
+
+## 우선순위 매트릭스
+
+| 우선순위 | Story |
+|----------|-------|
+| Must Have | STORY-001, STORY-002, ... |
+| Should Have | STORY-005, ... |
+| Could Have | STORY-008, ... |
+
+## 의존성 그래프
+
+[mermaid 다이어그램]
+
+## 스프린트 배분 제안
+
+### Sprint 1
+- STORY-001: [제목]
+- STORY-002: [제목]
+Total: X SP
+
+### Sprint 2
+...
+```
+
+---
+
+## 금지 사항
+
+### 절대 하지 말 것
+
+1. **PRD 없이 Epic/Story 작성 금지**
+   ```
+   ❌ "로그인 기능 스토리 만들어줘" → 바로 작성
+   ✅ "PRD가 있나요?" → PRD 분석 후 작성
+   ```
+
+2. **Acceptance Criteria 없는 Story 금지**
+   ```
+   ❌ Story에 User Story만 있고 AC 없음
+   ✅ 모든 Story에 Given-When-Then 형식의 AC 필수
+   → AC가 없으면 "언제 끝나는지" 알 수 없다
+   ```
+
+4. **모호한 Acceptance Criteria 금지**
+   ```
+   ❌ "적절히 동작해야 함", "사용자가 만족해야 함"
+   ✅ "Given 로그인 상태, When 로그아웃 클릭, Then 세션 종료"
+   ```
+
+5. **기술 중심 Story 금지**
+   ```
+   ❌ "Redis 캐시 구현", "JPA Entity 생성"
+   ✅ "사용자가 빠르게 검색 결과를 볼 수 있다"
+   ```
+
+6. **너무 큰 Story 금지**
+   ```
+   ❌ 13 SP 이상의 스토리
+   ✅ 5 SP 이하로 분해, 8 SP는 분해 검토
+   ```
+
+7. **의존성 무시 금지**
+   ```
+   ❌ 의존성 없이 모든 스토리 나열
+   ✅ 선행 스토리 명시, 의존성 그래프 제공
+   ```
+
+---
+
+## Good/Bad 예시
+
+### Epic
+
+```markdown
+# ✅ Good
+## [EPIC-001] 사용자 인증 시스템
+
+**목표**: 사용자가 안전하게 서비스에 로그인/로그아웃하여 개인화된 경험을 받을 수 있다
+
+**성공 지표**:
+- 로그인 성공률: 95% 이상
+- 비정상 로그인 시도 차단율: 99%
+
+# ❌ Bad
+## EPIC: 로그인 만들기
+→ 비즈니스 가치 없음, 성공 지표 없음
+```
+
+### Story
+
+```markdown
+# ✅ Good
+## [STORY-001] 이메일로 로그인
+
+AS A 등록된 사용자
+I WANT 이메일과 비밀번호로 로그인하고 싶다
+SO THAT 내 계정의 개인화된 기능을 사용할 수 있다
+
+**Acceptance Criteria**:
+Scenario: 유효한 자격증명으로 로그인
+  Given 사용자가 로그인 페이지에 있다
+  And 등록된 이메일 "user@example.com"이 있다
+  When 이메일 "user@example.com"과 올바른 비밀번호를 입력한다
+  And 로그인 버튼을 클릭한다
+  Then 홈 화면으로 이동한다
+  And 상단에 사용자 이름이 표시된다
+
+**Story Points**: 3
+
+# ❌ Bad
+## 로그인 기능 구현
+- 이메일 입력
+- 비밀번호 입력
+- 로그인 버튼
+→ 사용자 관점 없음, AC 없음
+```
+
+### Acceptance Criteria
+
+```markdown
+# ✅ Good (Given-When-Then)
+Scenario: 잘못된 비밀번호로 로그인 시도
+  Given 사용자가 로그인 페이지에 있다
+  When 올바른 이메일과 잘못된 비밀번호를 입력한다
+  And 로그인 버튼을 클릭한다
+  Then "이메일 또는 비밀번호가 올바르지 않습니다" 메시지가 표시된다
+  And 비밀번호 필드가 비워진다
+  And 5회 실패 시 계정이 5분간 잠긴다
+
+# ❌ Bad
+- 로그인 실패 시 에러 메시지 표시
+→ 구체적 조건 없음, 엣지케이스 누락
+```
+
+---
+
+## 체크리스트
+
+### Epic 작성 완료 확인
+- [ ] 비즈니스 목표가 명확한가?
+- [ ] 성공 지표가 측정 가능한가?
+- [ ] 2-8주 내 완료 가능한 크기인가?
+- [ ] 하위 Story 목록이 있는가?
+
+### Story 작성 완료 확인
+- [ ] INVEST 원칙을 충족하는가?
+- [ ] User Story 형식(As a/I want/So that)인가?
+- [ ] Acceptance Criteria가 Given-When-Then 형식인가?
+- [ ] Story Point가 8 이하인가?
+- [ ] 의존성이 명시되어 있는가?
+
+### 백로그 완성 확인
+- [ ] 모든 Epic이 PRD 요구사항을 커버하는가?
+- [ ] 우선순위(MoSCoW)가 지정되어 있는가?
+- [ ] 의존성 그래프가 있는가?
+- [ ] 스프린트 배분 제안이 있는가?
+
+---
+
+## 관련 스킬
+
+- `/skill:prd-generator`: PRD 생성 (Epic/Story 작성 전 필수)
+- `/skill:hld-generator`: HLD 생성 (설계 단계)
+- `/skill:lld-generator`: LLD 생성 (상세 설계)
+- `/skill:task-generator`: Implementation Task 생성 (구현 단계)
+
+---
+
+## 상세 템플릿
+
+- [Epic 템플릿](reference/epic-template.md)
+- [Story 템플릿](reference/story-template.md)