muno-claude-plugin 1.11.0 → 1.12.0

package/README.md

@@ -184,21 +184,24 @@ Task Level (단위 테스트)
 **호출 조건:** "Epic 생성해줘", "Story 만들어줘", "백로그 작성" 등의 요청 시 자동 호출
 
 **입력:** PRD 문서
-**출력:** `backlogs/<feature>/` 디렉토리
+**출력:** `documents/issues/{feature}/` 디렉토리
 
 **사용 예시:**
 ```
-@documents/prd/cart-prd.md 를 기반으로 Epic과 Story를 생성해주세요.
+@documents/request/cart-prd.md 를 기반으로 Epic과 Story를 생성해주세요.
 ```
 
 **생성 구조:**
 ```
-backlogs/cart-feature/
-├── index.md              # 전체 백로그 개요
-├── EPIC-001-cart.md      # Epic 정의
-├── STORY-001-add-item.md # User Story (AC 포함)
-├── STORY-002-remove-item.md
-└── ...
+documents/issues/cart/
+├── README.md                        # Epic 개요 (Epic이 있는 경우)
+├── stories/
+│   ├── STORY-001-add-item.md       # User Story (AC 포함)
+│   ├── STORY-002-remove-item.md
+│   └── ...
+└── tasks/                           # task-generator가 생성
+    └── STORY-{id}/
+        └── TASK-{seq}.md
 ```
 
 **User Story 포함 내용:**
@@ -267,21 +270,20 @@ backlogs/cart-feature/
 **호출 조건:** "태스크 생성해줘", "구현 작업 분해", "Task 만들어줘" 등의 요청 시 자동 호출
 
 **입력:** Story + LLD
-**출력:** `.tasks/<story-id>/` 디렉토리
+**출력:** `documents/issues/{feature}/tasks/STORY-{id}/` 디렉토리
 
 **사용 예시:**
 ```
-@backlogs/cart-feature/STORY-001-add-item.md
-@documents/lld/cart-lld.md
+@documents/issues/cart/stories/STORY-001-add-item.md
+@documents/system-design/features/cart/lld.md
 
 구현 태스크를 생성해주세요.
 ```
 
 **생성 구조:**
 ```
-.tasks/STORY-001/
-├── index.md              # 태스크 목록 및 의존성
-├── TASK-001-entity.md    # 엔티티 구현
+documents/issues/cart/tasks/STORY-001/
+├── TASK-001-entity.md
 ├── TASK-002-repository.md
 ├── TASK-003-service.md
 ├── TASK-004-controller.md
@@ -889,16 +891,31 @@ Task의 완료 조건(DoD)을 테스트로 변환합니다.
                                       상태 자동 업데이트
 ```
 
-### 문서 저장 위치
-
-| 산출물 | 위치 |
-|--------|------|
-| PRD | `documents/prd/<feature>-prd.md` |
-| HLD | `documents/hld/<feature>-hld.md` |
-| LLD | `documents/lld/<feature>-lld.md` |
-| Epic/Story | `backlogs/<feature>/` |
-| Task | `.tasks/<story-id>/` |
-| TC | `test-cases/<story-id>/` |
+### 문서 저장 위치 (Feature 기반 구조)
+
+```
+documents/
+├── request/
+│   └── <feature>-prd.md                    # PRD
+├── issues/
+│   ├── <feature>/                          # Feature별 그룹화
+│   │   ├── README.md                       # Epic 개요 (선택)
+│   │   ├── stories/
+│   │   │   └── STORY-<id>-<name>.md        # Story
+│   │   └── tasks/
+│   │       └── STORY-<id>/                 # Story별 Task 그룹화
+│   │           └── TASK-<id>.md            # Task
+│   └── standalone/                         # Epic/Feature 없는 독립 작업
+│       ├── stories/
+│       └── tasks/
+├── system-design/
+│   └── features/<feature>/
+│       ├── hld.md                          # HLD
+│       └── lld.md                          # LLD
+└── test/
+    ├── acceptance/AT-<id>.md               # Acceptance Test
+    └── unit/UT-<id>.md                     # Unit Test
+```
 
 ---
 
@@ -915,29 +932,30 @@ Task의 완료 조건(DoD)을 테스트로 변환합니다.
 - 세션 관리
 
 # 2. Epic/Story 생성 (epic-story-generator 스킬이 자동 호출됨)
-@documents/prd/auth-prd.md 기반으로 Epic과 Story를 생성해주세요.
+@documents/request/auth-prd.md 기반으로 Epic과 Story를 생성해주세요.
 
 # 3. TC 생성 (tc-generator 스킬이 자동 호출됨)
 # → 이후 tc-reviewer, acceptance-test-generator 서브에이전트가 자동 실행됨
-@backlogs/auth/STORY-001-email-login.md 에 대한 테스트 케이스를 작성해주세요.
+@documents/issues/auth/stories/STORY-001-email-login.md 에 대한 테스트 케이스를 작성해주세요.
 
 # 4. HLD 생성 (hld-generator 스킬이 자동 호출됨)
-@backlogs/auth/STORY-001-email-login.md 의 HLD를 작성해주세요.
+@documents/issues/auth/stories/STORY-001-email-login.md 의 HLD를 작성해주세요.
 
 # 5. LLD 생성 (lld-generator 스킬이 자동 호출됨)
-@backlogs/auth/STORY-001-email-login.md
-@documents/hld/auth-hld.md
+@documents/issues/auth/stories/STORY-001-email-login.md
+@documents/system-design/features/auth/hld.md
 위 문서를 기반으로 LLD를 작성해주세요.
 
 # 6. Task 생성 (task-generator 스킬이 자동 호출됨)
 # → 이후 unit-test-generator 서브에이전트가 자동으로 테스트 먼저 생성
-@backlogs/auth/STORY-001-email-login.md
-@documents/lld/auth-lld.md
+@documents/issues/auth/stories/STORY-001-email-login.md
+@documents/system-design/features/auth/lld.md
 구현 태스크를 생성해주세요.
 
 # 7. 구현 시작 (Developer 페르소나 활성화 - Command 사용)
 /dev
-TASK-001 구현을 시작하겠습니다. 테스트가 통과하도록 구현해주세요.
+@documents/issues/auth/tasks/STORY-001/TASK-001-entity.md 구현을 시작하겠습니다.
+테스트가 통과하도록 구현해주세요.
 ```
 
 ### Example 2: 버그 수정 (간단한 워크플로우)

package/bin/cli.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muno-claude-plugin",
-  "version": "1.11.0",
+  "version": "1.12.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": {
@@ -27,7 +27,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/headcha/muno-claude-plugin.git"
+    "url": "git+https://github.com/musinsa/muno-claude-plugin.git"
   },
   "engines": {
     "node": ">=18.0.0"

package/templates/agents/workflow-navigator.md

@@ -58,7 +58,7 @@ color: cyan
 ## PRD 작성 기준
 
 ```
-┌─────────────────────────────────────────────────────────────────┐
+┌───그럼 ──────────────────────────────────────────────────────────────┐
 │   PRD는 "새로운 요구사항"에 작성                                    │
 ├─────────────────────────────────────────────────────────────────┤
 │                                                                 │

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

@@ -275,70 +275,82 @@ Story 분해안을 검토해주세요.
 
 ## Step 4: 저장
 
-### 출력 구조
+### 출력 구조 (Feature 기반 그룹화)
 
 ```
-documents/
-└── issues/
-    ├── epics/
-    │   └── EPIC-xxx.md              # Epic 개별 문서
+documents/issues/
+├── {feature}/                       # Feature/Epic 이름 (예: auth, cart)
+│   ├── README.md                    # Epic 개요 (Epic이 있는 경우)
+│   ├── stories/
+│   │   ├── STORY-{id}-{name}.md     # Story 개별 문서
+│   │   └── ...
+│   └── tasks/
+│       ├── STORY-{id}/              # Story별 Task 그룹화
+│       │   ├── TASK-{id}.md
+│       │   └── ...
+│       └── ...
+└── standalone/                      # Epic/Feature 없는 독립 작업
     ├── stories/
-    │   └── STORY-xxx.md             # Story 개별 문서
     └── tasks/
-        └── TASK-xxx.md              # Task 개별 문서 (task-generator)
 ```
 
 **파일명 규칙**:
-- Epic: `EPIC-{number}-{kebab-case-name}.md` (예: `EPIC-001-user-authentication.md`)
-- Story: `STORY-{number}-{kebab-case-name}.md` (예: `STORY-001-email-login.md`)
-- Task: `TASK-{number}-{kebab-case-name}.md` (예: `TASK-001-login-entity.md`)
+- Feature 폴더: `{feature-name}` (예: `auth`, `cart`, `payment`)
+- Epic: `{feature}/README.md` (Epic 개요 포함)
+- Story: `{feature}/stories/STORY-{id}-{name}.md`
+- Task: `{feature}/tasks/STORY-{id}/TASK-{id}.md` (task-generator가 생성)
 
-**특징**:
-- Epic 없이 Story만 독립적으로 존재 가능
-- Story 없이 Task만 독립적으로 존재 가능
-- 각각 별도 폴더에서 독립적으로 관리
+**유연한 워크플로우 지원**:
+- Epic 있음: `{feature}/README.md` + `stories/`
+- Epic 없음: `{feature}/stories/` (README.md 없이)
+- Story 없음: `standalone/tasks/` (독립 Task)
 
-### index.md 구조
+### README.md 구조 (Epic 개요)
+
+Epic이 있는 경우 `{feature}/README.md`에 작성:
 
 ```markdown
-# [기능명] Backlog
+# Epic: [기능명]
 
 ## 개요
-- **PRD**: [PRD 경로]
-- **총 Epic**: N개
-- **총 Story**: M개
+- **PRD**: documents/request/{기능명}-prd.md
+- **총 Story**: N개
 - **예상 기간**: X 스프린트
 
-## Epic 목록
+## 비즈니스 목표
+[Epic의 비즈니스 가치]
+
+## Story 목록
 
-| Epic ID | 제목 | Story 수 | 상태 |
-|---------|------|----------|------|
-| EPIC-001 | ... | 5 | Not Started |
-| EPIC-002 | ... | 3 | Not Started |
+| Story ID | 제목 | 크기 | 상태 |
+|---------|------|------|------|
+| STORY-001 | ... | S | Not Started |
+| STORY-002 | ... | M | Not Started |
 
-## 우선순위 매트릭스
+## 우선순위
 
 | 우선순위 | Story |
 |----------|-------|
-| Must Have | STORY-001, STORY-002, ... |
-| Should Have | STORY-005, ... |
-| Could Have | STORY-008, ... |
+| Must Have | STORY-001, STORY-002 |
+| Should Have | STORY-005 |
+| Could Have | STORY-008 |
 
-## 의존성 그래프
+## 의존성
 
-[mermaid 다이어그램]
+[mermaid 다이어그램 - 필요시]
 
 ## 스프린트 배분 제안
 
 ### Sprint 1
-- STORY-001: [제목]
-- STORY-002: [제목]
-Total: X SP
+- STORY-001: [제목] (3 SP)
+- STORY-002: [제목] (5 SP)
 
 ### Sprint 2
 ...
 ```
 
+**Epic 없는 경우**: README.md 생략하고 `stories/` 바로 생성
+
 ---
 
 ## Epic/Story 작성 완료 후 필수 작업
@@ -354,7 +366,7 @@ Task 도구를 사용하여 다음과 같이 호출합니다:
 ```
 Task 도구 호출:
 - subagent_type: epic-story-reviewer
-- prompt: "다음 백로그 폴더의 Epic/Story 문서를 검토해주세요: {백로그 폴더 경로}"
+- prompt: "다음 Feature 폴더의 Epic/Story 문서를 검토해주세요: documents/issues/{feature}/"
 ```
 
 **다음 단계 조건**:

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

@@ -388,30 +388,64 @@ Task 분해안을 검토해주세요.
 
 ### Task 필수 섹션 (7개)
 
-각 Task는 **7개 핵심 섹션**을 반드시 포함합니다:
+각 Task는 **Frontmatter + 7개 핵심 섹션**을 반드시 포함합니다:
 
 ```markdown
-# TASK-XXX: [Task 이름]
+---
+id: TASK-{seq}
+title: [Task 이름]
+story_id: STORY-{id}
+feature: {feature-name}
+status: todo
+related_docs:
+  prd: documents/request/{feature}-prd.md
+  epic: documents/issues/{feature}/README.md  # Epic이 있는 경우
+  story: documents/issues/{feature}/stories/STORY-{id}-{name}.md
+  hld: documents/system-design/features/{feature}/hld.md  # 있는 경우
+  lld: documents/system-design/features/{feature}/lld.md  # 있는 경우
+---
+
+# TASK-{seq}: [Task 이름]
+
+## 🔗 참고 자료 (코딩 전 필독)
+
+**이 Task를 구현하기 전에 다음 문서들을 반드시 읽어주세요:**
+
+### 필수 문서
+- **Story**: @documents/issues/{feature}/stories/STORY-{id}-{name}.md
+  - 이 Task가 충족해야 할 Acceptance Criteria
+  - 사용자 관점의 기대 동작
+
+### 설계 문서 (있는 경우)
+- **LLD**: @documents/system-design/features/{feature}/lld.md
+  - API 명세, 데이터 모델, 시퀀스 다이어그램
+- **HLD**: @documents/system-design/features/{feature}/hld.md
+  - 전체 아키텍처, 컴포넌트 구조
+
+### 비즈니스 맥락 (있는 경우)
+- **PRD**: @documents/request/{feature}-prd.md
+  - 비즈니스 요구사항, 문제 정의
+- **Epic**: @documents/issues/{feature}/README.md
+  - Epic 전체 목표
+
+---
 
 ## 1. Context (맥락)
 왜 이 Task가 필요한가, User Story와의 연결
 
-## 2. Document References (참조 문서 임포트)
-코딩 에이전트가 참고해야 할 문서들과 핵심 내용 발췌
-
-## 3. Scope (범위)
+## 2. Scope (범위)
 생성할 파일, 선행 Task, 예상 소요
 
-## 4. Reference Code (참조 코드)
+## 3. Reference Code (참조 코드)
 기존 코드베이스에서 따라야 할 패턴
 
-## 5. Implementation Spec (구현 명세)
+## 4. Implementation Spec (구현 명세)
 조건, 요구사항, 의사 코드 (구현 코드 X)
 
-## 6. Acceptance Criteria (완료 조건)
+## 5. Acceptance Criteria (완료 조건)
 체크리스트 형태의 명확한 완료 기준
 
-## 7. Test Scenarios (테스트 시나리오)
+## 6. Test Scenarios (테스트 시나리오)
 구체적인 테스트 케이스와 값
 ```
 
@@ -445,68 +479,12 @@ Task 분해안을 검토해주세요.
 - **후행**: TASK-XXX (이 Task가 완료되어야 시작 가능)
 ```
 
-### 2. Document References (참조 문서 임포트) - 핵심!
+**참고**: "🔗 참고 자료" 섹션은 이미 템플릿 상단에 추가되었으므로 별도 가이드 불필요
 
-**코딩 에이전트가 추론하지 않도록, 필요한 정보를 직접 임포트한다.**
+### 2. Scope (범위)
 
 ```markdown
-## 2. Document References
-
-### 2.1 User Story (Required)
-
-**파일**: `backlogs/feature-name/STORY-XXX.md`
-
-**Acceptance Criteria 발췌**:
-```gherkin
-Scenario: [정상 케이스]
-  Given [전제 조건]
-  When [사용자 행동]
-  Then [기대 결과]
-```
-
-### 2.2 LLD (Required)
-
-**파일**: `documents/lld/xxx-lld.md`
-
-**ERD 발췌**:
-```
-[Table 정의 발췌]
-```
-
-**API Spec 발췌** (해당시):
-```
-POST /api/v1/xxx
-Request: {...}
-Response: {...}
-```
-
-**서비스 메서드 정의 발췌**:
-```
-createXxx(command: CreateXxxCommand): XxxDto
-```
-
-### 2.3 HLD (Optional)
-
-**파일**: `documents/hld/xxx-hld.md`
-
-**아키텍처 컨텍스트** (필요한 부분만):
-```
-[컴포넌트 관계, 데이터 흐름 등]
-```
-
-### 2.4 코드베이스 컨벤션
-
-**참조 파일**: `CLAUDE.md`
-
-**적용할 규칙**:
-- [컨벤션 1]
-- [컨벤션 2]
-```
-
-### 3. Scope (범위)
-
-```markdown
-## 3. Scope
+## 2. Scope
 
 | 항목 | 내용 |
 |-----|------|
@@ -515,10 +493,10 @@ createXxx(command: CreateXxxCommand): XxxDto
 | 예상 라인 | 약 150줄 |
 ```
 
-### 4. Reference Code (참조 코드)
+### 3. Reference Code (참조 코드)
 
 ```markdown
-## 4. Reference Code
+## 3. Reference Code
 
 **참조 파일**: `core/src/main/kotlin/com/example/domain/user/model/UserEntity.kt`
 
@@ -539,14 +517,14 @@ class UserEntity(
 - [ ] @Column(name = "snake_case") 명시
 ```
 
-### 5. Implementation Spec (구현 명세)
+### 4. Implementation Spec (구현 명세)
 
 > **주의**: 구현 코드를 포함하지 않는다. 조건과 요구사항만 정의한다.
 
 ```markdown
-## 5. Implementation Spec
+## 4. Implementation Spec
 
-### 5.1 데이터 정의
+### 4.1 데이터 정의
 
 | 필드 | 타입 | 제약조건 | 설명 |
 |------|------|----------|------|
@@ -556,7 +534,7 @@ class UserEntity(
 | title | String | Not Null, Max 100 | 제목 |
 | status | Enum | Not Null, Default ACTIVE | 상태 |
 
-### 5.2 비즈니스 규칙
+### 4.2 비즈니스 규칙
 
 | ID | 규칙 | 설명 |
 |----|------|------|
@@ -564,14 +542,14 @@ class UserEntity(
 | BR-02 | 제목 검증 | title은 1-100자 |
 | BR-03 | 외부 ID | UUIDv7로 자동 생성 |
 
-### 5.3 메서드 시그니처 (Service의 경우)
+### 4.3 메서드 시그니처 (Service의 경우)
 
 | 메서드 | 입력 | 출력 | 설명 |
 |--------|-----|------|------|
 | create | CreateCommand | Dto | 생성 |
 | getById | UUID, Long | Dto | 조회 (권한 검증) |
 
-### 5.4 의사 코드 (복잡한 로직의 경우)
+### 4.4 의사 코드 (복잡한 로직의 경우)
 
 ```
 // updateTitle 로직
@@ -584,12 +562,12 @@ class UserEntity(
 ```
 ```
 
-### 6. Acceptance Criteria (완료 조건)
+### 5. Acceptance Criteria (완료 조건)
 
 **Story의 AC에서 이 Task가 충족해야 할 부분을 명시한다.**
 
 ```markdown
-## 6. Acceptance Criteria
+## 5. Acceptance Criteria
 
 ### Story AC 연결
 - [ ] Story AC-1의 "[특정 부분]"을 이 Task에서 구현
@@ -605,14 +583,14 @@ class UserEntity(
 - [ ] `./gradlew test` 기존 테스트 통과
 ```
 
-### 7. Test Scenarios (테스트 시나리오)
+### 6. Test Scenarios (테스트 시나리오)
 
 > **주의**: 테스트 코드를 포함하지 않는다. 시나리오와 입출력 값만 정의한다.
 
 ```markdown
-## 7. Test Scenarios
+## 6. Test Scenarios
 
-### 7.1 Happy Path
+### 6.1 Happy Path
 
 **Story AC 연결**: Story AC-1 "정상적으로 생성"
 
@@ -631,7 +609,7 @@ class UserEntity(
 | status | ACTIVE |
 | createdAt | 현재 시간 |
 
-### 7.2 Edge Cases
+### 6.2 Edge Cases
 
 **Story AC 연결**: Story AC-2 "유효성 검증"
 
@@ -641,14 +619,14 @@ class UserEntity(
 | 100자 초과 | title = "가" × 101 | IllegalArgumentException |
 | null userId | userId = null | NullPointerException (컴파일 타임) |
 
-### 7.3 권한 검증 (해당시)
+### 6.3 권한 검증 (해당시)
 
 | 시나리오 | 조건 | 기대 결과 |
 |---------|------|----------|
 | 타인 접근 | chatRoom.userId ≠ requestUserId | AccessDeniedException |
 | 본인 접근 | chatRoom.userId = requestUserId | 정상 처리 |
 
-### 7.4 검증 쿼리 (DB 확인용)
+### 6.4 검증 쿼리 (DB 확인용)
 
 - 생성 확인: `SELECT * FROM [table] WHERE external_id = ?`
 - 인덱스 확인: `SHOW INDEX FROM [table]`
@@ -712,43 +690,46 @@ class UserEntity(
 
 ---
 
-## 출력 구조
+## 출력 구조 (Feature 기반 그룹화)
 
 ```
-documents/
-└── issues/
+documents/issues/
+├── {feature}/                           # Feature 이름 (Story와 동일 폴더)
+│   └── tasks/
+│       └── STORY-{id}/                  # Story별 Task 그룹화
+│           ├── TASK-001-{name}.md
+│           ├── TASK-002-{name}.md
+│           └── ...
+└── standalone/                          # 독립 Task
     └── tasks/
-        └── TASK-{story-id}-{seq}-{kebab-case-name}.md
+        ├── TASK-001-{name}.md
+        └── ...
 ```
 
 **파일명 규칙**:
 
-| Task 유형 | 파일명 패턴 | 예시 |
-|----------|------------|------|
-| Story 기반 | `TASK-{STORY-ID}-{seq}-{name}.md` | `TASK-S001-01-chatroom-entity.md` |
-| Epic 기반 | `TASK-{EPIC-ID}-{seq}-{name}.md` | `TASK-E001-01-db-migration.md` |
-| 독립 Task | `TASK-IND-{seq}-{name}.md` | `TASK-IND-01-fix-login-bug.md` |
+| Task 유형 | 위치 | 파일명 | 예시 |
+|----------|------|--------|------|
+| Story 기반 | `{feature}/tasks/STORY-{id}/` | `TASK-{seq}-{name}.md` | `auth/tasks/STORY-001/TASK-001-entity.md` |
+| 독립 Task | `standalone/tasks/` | `TASK-{id}-{name}.md` | `standalone/tasks/TASK-001-hotfix.md` |
 
-**예시 (Story 기반)**:
+**예시 (auth Feature)**:
 ```
-documents/issues/tasks/
-├── TASK-S001-01-chatroom-entity.md       # Story-001의 1번째 Task
-├── TASK-S001-02-chatroom-repository.md   # Story-001의 2번째 Task
-├── TASK-S001-03-chatroom-service.md      # Story-001의 3번째 Task
-├── TASK-S002-01-message-entity.md        # Story-002의 1번째 Task
-└── TASK-IND-01-refactor-auth.md          # 독립 Task
+documents/issues/auth/
+└── tasks/
+    ├── STORY-001/                       # Story-001의 Task들
+    │   ├── TASK-001-entity.md
+    │   ├── TASK-002-repository.md
+    │   └── TASK-003-service.md
+    └── STORY-002/                       # Story-002의 Task들
+        ├── TASK-001-controller.md
+        └── TASK-002-validator.md
 ```
 
-**ID 규칙**:
-- `S001` = Story-001 (Story 기반)
-- `E001` = Epic-001 (Epic 기반)
-- `IND` = Independent (독립 Task)
-- `seq` = 01, 02, 03... (순번)
-
 **특징**:
-- 파일명만 보고 상위 Story/Epic 연결 파악 가능
-- 같은 Story의 Task들이 파일 탐색기에서 그룹핑됨
-- 상위 Epic/Story 링크는 문서 내부 frontmatter에서도 관리
+- Story별로 Task가 폴더로 그룹화되어 관리 용이
+- Feature 단위로 모든 문서가 함께 위치
+- 파일 탐색과 맥락 파악이 쉬움
 
 ---