muno-claude-plugin 1.10.0 → 1.11.0

package/README.md

@@ -29,8 +29,8 @@ AI 기반 소프트웨어 개발의 전체 라이프사이클을 지원합니다
 npx muno-claude-plugin install
 
 # Claude Code에서 사용
-/prd-generator        # PRD 문서 생성
-/dev                  # Developer 페르소나 활성화
+"PRD 작성해줘"        # PRD 문서 자동 생성 (prd-generator 스킬 호출)
+/dev                  # Developer 페르소나 활성화 (Command 사용)
 ```
 
 30초 만에 시작하세요. 설치 후 Claude Code에서 바로 사용 가능합니다.
@@ -96,7 +96,7 @@ npx muno-claude-plugin install-user
 │   ├── unit-test-generator.md
 │   ├── task-tracker.md
 │   └── ...
-├── skills/              # 워크플로우 스킬 (/command로 호출)
+├── skills/              # 워크플로우 스킬 (자동 호출)
 │   ├── prd-generator/
 │   ├── epic-story-generator/
 │   ├── hld-generator/
@@ -113,13 +113,13 @@ npx muno-claude-plugin install-user
 
 ## Core Concepts
 
-### Skills vs Personas vs Subagents
+### Skills vs Commands vs Subagents
 
 | 구분 | 호출 방식 | 용도 | 예시 |
 |------|----------|------|------|
-| **Skill** | `/skill-name` (명시적) | 특정 산출물 생성 | `/prd-generator` |
-| **Persona** | `/persona-name` (명시적) | 역할 기반 대화 | `/dev`, `/qa` |
-| **Subagent** | 자동 호출 | 품질 검증, 테스트 생성 | tc-reviewer |
+| **Skill** | 자동 호출 | 특정 산출물 생성 | prd-generator, hld-generator |
+| **Command** | `/command-name` (슬래시 명령어) | 페르소나 활성화 등 | `/dev`, `/qa`, `/po` |
+| **Subagent** | 자동 호출 | 품질 검증, 테스트 생성 | tc-reviewer, code-reviewer |
 
 ### TDD Workflow (2-Level)
 
@@ -139,17 +139,27 @@ Task Level (단위 테스트)
 
 ## Skills Reference
 
-### /prd-generator
+> Skills는 Claude Code가 자동으로 인식하여 호출합니다. 사용자가 특정 요청을 하면 Claude Code가 적절한 스킬을 자동으로 실행합니다.
 
-**Product Requirements Document 생성**
+**구현된 Skills 목록:**
+- **문서 생성**: prd-generator, epic-story-generator, hld-generator, lld-generator
+- **개발 작업**: task-generator, tc-generator
+- **디자인**: app-design, architecture-design
+- **API 문서**: swagger-docs-generator
+- **리뷰**: task-reviewer
 
-입력: 요구사항 (자연어)
-출력: `documents/prd/<feature>-prd.md`
+### prd-generator
 
-```
-/prd-generator
+**Product Requirements Document 자동 생성**
+
+**호출 조건:** "PRD 작성해줘", "기획서 만들어줘", "요구사항 정의서 작성" 등의 요청 시 자동 호출
+
+**입력:** 요구사항 (자연어)
+**출력:** `documents/prd/<feature>-prd.md`
 
-사용자가 상품을 장바구니에 담고 주문할 수 있는 기능이 필요합니다.
+**사용 예시:**
+```
+사용자가 상품을 장바구니에 담고 주문할 수 있는 기능의 PRD를 작성해줘.
 - 장바구니 담기/빼기
 - 수량 변경
 - 주문서 작성
@@ -167,16 +177,17 @@ Task Level (단위 테스트)
 
 ---
 
-### /epic-story-generator
+### epic-story-generator
 
-**Epic & User Story 생성**
+**Epic & User Story 자동 생성**
 
-입력: PRD 문서
-출력: `backlogs/<feature>/` 디렉토리
+**호출 조건:** "Epic 생성해줘", "Story 만들어줘", "백로그 작성" 등의 요청 시 자동 호출
 
-```
-/epic-story-generator
+**입력:** PRD 문서
+**출력:** `backlogs/<feature>/` 디렉토리
 
+**사용 예시:**
+```
 @documents/prd/cart-prd.md 를 기반으로 Epic과 Story를 생성해주세요.
 ```
 
@@ -198,16 +209,17 @@ backlogs/cart-feature/
 
 ---
 
-### /hld-generator
+### hld-generator
 
-**High-Level Design 생성**
+**High-Level Design 자동 생성**
 
-입력: Story 또는 PRD
-출력: `documents/hld/<feature>-hld.md`
+**호출 조건:** "HLD 작성해줘", "시스템 설계", "아키텍처 문서" 등의 요청 시 자동 호출
 
-```
-/hld-generator
+**입력:** Story 또는 PRD
+**출력:** `documents/hld/<feature>-hld.md`
 
+**사용 예시:**
+```
 @backlogs/cart-feature/STORY-001-add-item.md 에 대한 HLD를 작성해주세요.
 ```
 
@@ -221,16 +233,17 @@ backlogs/cart-feature/
 
 ---
 
-### /lld-generator
+### lld-generator
 
-**Low-Level Design 생성**
+**Low-Level Design 자동 생성**
 
-입력: Story + HLD
-출력: `documents/lld/<feature>-lld.md`
+**호출 조건:** "LLD 작성해줘", "상세 설계", "API 명세" 등의 요청 시 자동 호출
 
-```
-/lld-generator
+**입력:** Story + HLD
+**출력:** `documents/lld/<feature>-lld.md`
 
+**사용 예시:**
+```
 @backlogs/cart-feature/STORY-001-add-item.md
 @documents/hld/cart-hld.md
 
@@ -247,16 +260,17 @@ backlogs/cart-feature/
 
 ---
 
-### /task-generator
+### task-generator
 
-**Implementation Task 생성**
+**Implementation Task 자동 생성**
 
-입력: Story + LLD
-출력: `.tasks/<story-id>/` 디렉토리
+**호출 조건:** "태스크 생성해줘", "구현 작업 분해", "Task 만들어줘" 등의 요청 시 자동 호출
 
-```
-/task-generator
+**입력:** Story + LLD
+**출력:** `.tasks/<story-id>/` 디렉토리
 
+**사용 예시:**
+```
 @backlogs/cart-feature/STORY-001-add-item.md
 @documents/lld/cart-lld.md
 
@@ -283,16 +297,17 @@ backlogs/cart-feature/
 
 ---
 
-### /tc-generator
+### tc-generator
 
-**Test Case 생성**
+**Test Case 자동 생성**
 
-입력: Story (Acceptance Criteria)
-출력: `test-cases/<story-id>/` 디렉토리
+**호출 조건:** "테스트 케이스 작성해줘", "TC 만들어줘", "테스트 시나리오 생성" 등의 요청 시 자동 호출
 
-```
-/tc-generator
+**입력:** Story (Acceptance Criteria)
+**출력:** `test-cases/<story-id>/` 디렉토리
 
+**사용 예시:**
+```
 @backlogs/cart-feature/STORY-001-add-item.md
 
 AC 기반 테스트 케이스를 생성해주세요.
@@ -314,16 +329,17 @@ test-cases/STORY-001/
 
 ---
 
-### /app-design
+### app-design
 
-**UI/UX 디자인 생성**
+**UI/UX 디자인 자동 생성**
 
-입력: 디자인 요청 (화면, 기능, 컴포넌트)
-출력: 디자인 스펙 문서
+**호출 조건:** "UI 디자인해줘", "화면 설계", "UX 만들어줘" 등의 요청 시 자동 호출
 
-```
-/app-design
+**입력:** 디자인 요청 (화면, 기능, 컴포넌트)
+**출력:** 디자인 스펙 문서
 
+**사용 예시:**
+```
 로그인 화면을 디자인해주세요.
 - 이메일/비밀번호 입력
 - 소셜 로그인 (Apple, Google)
@@ -351,16 +367,17 @@ test-cases/STORY-001/
 
 ---
 
-### /swagger-docs-generator
+### swagger-docs-generator
 
-**Swagger/OpenAPI 문서 → Markdown 변환**
+**Swagger/OpenAPI 문서 → Markdown 자동 변환**
 
-입력: Swagger 문서 URL
-출력: `documents/api/<service>-api-docs.md`
+**호출 조건:** "API 문서 만들어줘", "Swagger 문서화", "OpenAPI 변환" 등의 요청 시 자동 호출
 
-```
-/swagger-docs-generator
+**입력:** Swagger 문서 URL
+**출력:** `documents/api/<service>-api-docs.md`
 
+**사용 예시:**
+```
 http://localhost:8080/v3/api-docs 의 API 문서를 생성해주세요.
 ```
 
@@ -385,6 +402,61 @@ http://localhost:8080/v3/api-docs 의 API 문서를 생성해주세요.
 
 ---
 
+### architecture-design
+
+**System Architecture Document (SAD) 자동 생성**
+
+**호출 조건:** "아키텍처 문서 만들어줘", "시스템 구조", "전체 아키텍처" 등의 요청 시 자동 호출
+
+**입력:** 시스템 요구사항
+**출력:** `documents/architecture/system-architecture.md`
+
+**사용 예시:**
+```
+전체 시스템 아키텍처 문서를 작성해주세요.
+현재 프로젝트는 Spring Boot 기반 백엔드와 React 프론트엔드로 구성됩니다.
+```
+
+**SAD 포함 내용:**
+- 시스템 컨텍스트 및 비즈니스 목표
+- 전체 컴포넌트 구성
+- 기술 스택 및 인프라
+- 데이터 흐름 및 통신 패턴
+- 보안 아키텍처
+- 확장성 전략
+
+**SAD vs Feature HLD:**
+- SAD: 전체 시스템 1개 (지속적 업데이트)
+- HLD: 각 피처별 다수 (피처 단위 설계)
+
+---
+
+### task-reviewer
+
+**Implementation Task 품질 검증**
+
+**호출 조건:** "태스크 검토해줘", "Task 리뷰해줘", "구현 스펙 검증" 등의 요청 시 자동 호출
+
+**입력:** 생성된 Implementation Tasks
+**출력:** 검토 결과 및 개선 제안
+
+**사용 예시:**
+```
+.tasks/STORY-001/ 디렉토리의 태스크들을 검토해주세요.
+코딩 에이전트가 바로 구현할 수 있는 수준인지 확인해주세요.
+```
+
+**검토 기준:**
+- 명시성: 추론 없이 구현 가능한 명확성
+- 완전성: 필요한 모든 정보 포함 여부
+- 구체성: 파일명, 클래스명, 메서드 시그니처 명시
+- 테스트 가능성: DoD(Definition of Done) 명확성
+
+**핵심 원칙:**
+> 코딩 에이전트는 추론하면 틀린다. Task에 모든 정보가 명시적으로 포함되어야 한다.
+
+---
+
 ## Personas Reference
 
 ### /dev - Developer
@@ -595,7 +667,13 @@ MCP 서버를 설정하는 방법을 알려주세요.
 
 ## Subagents Reference
 
-Subagent는 특정 시점에 **자동으로 호출**됩니다.
+> Subagent는 특정 시점에 **자동으로 호출**됩니다. 사용자가 직접 호출할 필요 없이 Claude Code가 적절한 시점에 자동으로 실행합니다.
+
+**구현된 Subagents 목록:**
+- **문서 리뷰**: prd-reviewer, epic-story-reviewer, hld-reviewer, lld-reviewer
+- **코드 리뷰**: code-reviewer
+- **테스트 관련**: tc-reviewer, acceptance-test-generator, unit-test-generator
+- **프로젝트 관리**: task-tracker, workflow-navigator
 
 ### code-reviewer
 
@@ -658,10 +736,68 @@ Task의 완료 조건(DoD)을 테스트로 변환합니다.
 
 ---
 
-### prd-reviewer / epic-story-reviewer / hld-reviewer / lld-reviewer
+### prd-reviewer
+
+**호출 시점:** PRD 생성 후
+**역할:** PRD 품질 검증 및 개선점 제안
+
+검토 기준:
+- 문제 정의 명확성
+- 요구사항 완전성
+- 성공 지표 측정 가능성
+- 범위 및 제약사항 명확성
+
+---
+
+### epic-story-reviewer
+
+**호출 시점:** Epic/Story 생성 후
+**역할:** Epic/Story 품질 검증 및 AC(Acceptance Criteria) 검토
+
+검토 기준:
+- Epic의 비즈니스 가치 명확성
+- Story의 독립성 및 완결성
+- AC의 명확성 및 테스트 가능성
+- Story 크기의 적정성
+
+---
+
+### hld-reviewer
+
+**호출 시점:** HLD 생성 후
+**역할:** 시스템 아키텍처 검증 및 기술 선택 검토
+
+검토 기준:
+- 아키텍처 패턴 적합성
+- 기술 스택 선택의 타당성
+- 확장성 및 성능 고려
+- 보안 및 규정 준수
+
+---
+
+### lld-reviewer
+
+**호출 시점:** LLD 생성 후
+**역할:** 상세 설계 검증 및 구현 가능성 검토
+
+검토 기준:
+- API 설계 일관성
+- 데이터 모델 정규화
+- 에러 처리 전략
+- 구현 가능성 및 복잡도
+
+---
+
+### workflow-navigator
+
+**호출 시점:** 워크플로우 단계 전환 시
+**역할:** 개발 워크플로우 가이드 및 다음 단계 제안
 
-**호출 시점:** 각 산출물 생성 후
-**역할:** 품질 검토 및 피드백 제공
+기능:
+- 현재 워크플로우 단계 파악
+- 다음 수행 작업 제안
+- 필요한 산출물 확인
+- 누락된 단계 알림
 
 ---
 
@@ -770,40 +906,36 @@ Task의 완료 조건(DoD)을 테스트로 변환합니다.
 
 ### Example 1: 새 기능 개발 (Full Workflow)
 
-```bash
-# 1. PRD 생성
-/prd-generator
-"""
-사용자 인증 기능이 필요합니다.
+```
+# 1. PRD 생성 (prd-generator 스킬이 자동 호출됨)
+사용자 인증 기능의 PRD를 작성해주세요.
 - 이메일/비밀번호 로그인
 - 소셜 로그인 (Google, Apple)
 - 비밀번호 재설정
 - 세션 관리
-"""
 
-# 2. Epic/Story 생성
-/epic-story-generator
-@documents/prd/auth-prd.md 기반으로 생성해주세요.
+# 2. Epic/Story 생성 (epic-story-generator 스킬이 자동 호출됨)
+@documents/prd/auth-prd.md 기반으로 Epic과 Story를 생성해주세요.
 
-# 3. TC 생성 (자동으로 tc-reviewer, acceptance-test-generator 호출됨)
-/tc-generator
-@backlogs/auth/STORY-001-email-login.md
+# 3. TC 생성 (tc-generator 스킬이 자동 호출됨)
+# → 이후 tc-reviewer, acceptance-test-generator 서브에이전트가 자동 실행됨
+@backlogs/auth/STORY-001-email-login.md 에 대한 테스트 케이스를 작성해주세요.
 
-# 4. HLD 생성
-/hld-generator
-@backlogs/auth/STORY-001-email-login.md
+# 4. HLD 생성 (hld-generator 스킬이 자동 호출됨)
+@backlogs/auth/STORY-001-email-login.md 의 HLD를 작성해주세요.
 
-# 5. LLD 생성
-/lld-generator
+# 5. LLD 생성 (lld-generator 스킬이 자동 호출됨)
 @backlogs/auth/STORY-001-email-login.md
 @documents/hld/auth-hld.md
+위 문서를 기반으로 LLD를 작성해주세요.
 
-# 6. Task 생성 (자동으로 unit-test-generator가 테스트 먼저 생성)
-/task-generator
+# 6. Task 생성 (task-generator 스킬이 자동 호출됨)
+# → 이후 unit-test-generator 서브에이전트가 자동으로 테스트 먼저 생성
 @backlogs/auth/STORY-001-email-login.md
 @documents/lld/auth-lld.md
+구현 태스크를 생성해주세요.
 
-# 7. 구현 시작 (Developer 페르소나 활용)
+# 7. 구현 시작 (Developer 페르소나 활성화 - Command 사용)
 /dev
 TASK-001 구현을 시작하겠습니다. 테스트가 통과하도록 구현해주세요.
 ```

package/bin/cli.js

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

package/package.json

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