muno-claude-plugin 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muno-claude-plugin",
-  "version": "1.5.0",
+  "version": "1.6.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": {

package/templates/WORKFLOW.md

@@ -73,29 +73,30 @@ AI 기반 개발 워크플로우 스킬 체계입니다.
 ## 문서 저장 구조
 
 ```
-project/
-├── documents/
-│   ├── architecture/
-│   │   └── system-architecture.md   ← SAD (1개, 지속 업데이트)
-│   ├── prd/
-│   │   └── feature-prd.md
-│   ├── hld/
-│   │   └── feature-hld.md           ← Feature HLD (피처별)
-│   └── lld/
-│       └── feature-lld.md
+documents/
+├── system-design/
+│   ├── architecture.md              ← 전체 시스템 아키텍처 (SAD, 1개)
+│   └── features/
+│       └── {feature-name}/
+│           ├── hld.md               ← Feature HLD
+│           └── lld.md               ← Feature LLD
 │
-├── backlogs/         # Epic/Story
-│   └── feature-name/
-│       ├── index.md
-│       └── STORY-xxx.md
+├── request/
+│   └── {feature-name}-prd.md        ← PRD
 │
-├── .tasks/           # Task
-│   └── STORY-xxx/
-│       └── TASK-xxx.md
+├── issues/
+│   ├── epics/
+│   │   └── EPIC-xxx.md              ← Epic
+│   ├── stories/
+│   │   └── STORY-xxx.md             ← Story (Epic 없이 독립 가능)
+│   └── tasks/
+│       └── TASK-xxx.md              ← Task (Story 없이 독립 가능)
 │
-└── test-cases/       # Test Cases
-    └── STORY-xxx/
-        └── TC-xxx.md
+└── test/
+    ├── unit/
+    │   └── UT-xxx.md                ← Unit Test Case
+    └── acceptance/
+        └── AT-xxx.md                ← Acceptance Test Case
 ```
 
 ---

package/templates/agents/acceptance-test-generator.md

@@ -106,8 +106,8 @@ TC 생성 및 리뷰 흐름:
 
 1. tc-generator 실행
    └─ Story AC 분석
-   └─ TC 문서 생성 (test-cases/STORY-XXX/)
-   └─ TC index.md 생성
+   └─ AT 문서 생성 (documents/test/acceptance/AT-XXX.md)
+   └─ UT 문서 생성 (documents/test/unit/UT-XXX.md)
          │
          ▼
 2. tc-reviewer 자동 호출
@@ -125,12 +125,12 @@ TC 생성 및 리뷰 흐름:
 
 ---
 
-## 입력: TC 문서 구조
+## 입력: AT 문서 구조
 
 ```yaml
-# test-cases/STORY-001/TC-001-01-create-chatroom.md
+# documents/test/acceptance/AT-001-create-chatroom.md
 ---
-id: TC-001-01
+id: AT-001
 title: 채팅방 생성 - Happy Path
 story_id: STORY-001
 type: integration
@@ -345,12 +345,12 @@ func TestChatRoomAcceptance(t *testing.T) {
 
 ## 생성 워크플로우
 
-### Step 1: TC 분석
+### Step 1: AT 분석
 
 ```
-1. TC 문서 읽기 (test-cases/STORY-XXX/*.md)
-2. TC index.md에서 전체 TC 목록 확인
-3. 각 TC의 유형 파악 (integration, e2e, etc.)
+1. AT 문서 읽기 (documents/test/acceptance/AT-XXX.md)
+2. 전체 AT 목록 확인
+3. 각 AT의 유형 파악 (integration, e2e, etc.)
 4. 우선순위 확인 (high, medium, low)
 ```
 
@@ -465,19 +465,18 @@ src/test/kotlin/com/example/
 ## 체크리스트
 
 ### 테스트 생성 전
-- [ ] TC 문서가 생성되었는가?
-- [ ] TC index.md가 있는가?
-- [ ] 각 TC의 사전 조건/기대 결과가 명확한가?
+- [ ] AT 문서가 생성되었는가? (documents/test/acceptance/)
+- [ ] 각 AT의 사전 조건/기대 결과가 명확한가?
 
 ### 테스트 생성 후
-- [ ] 모든 TC가 테스트 메서드로 변환되었는가?
-- [ ] @DisplayName에 TC ID가 포함되어 있는가?
+- [ ] 모든 AT가 테스트 메서드로 변환되었는가?
+- [ ] @DisplayName에 AT ID가 포함되어 있는가?
 - [ ] 사전 조건이 Arrange로 변환되었는가?
 - [ ] 기대 결과가 Assert로 변환되었는가?
 - [ ] 테스트가 컴파일되는가?
 
 ### Story-Level TDD 확인
-- [ ] TC 생성 직후 테스트가 작성되었는가?
+- [ ] AT 생성 직후 테스트가 작성되었는가?
 - [ ] 테스트 실행 시 실패하는가? (Red)
 - [ ] Task 구현 후 테스트가 통과하는가? (Green)
 

package/templates/agents/task-tracker.md

@@ -200,23 +200,24 @@ Epic (EPIC-001)
 ### 파일 저장 위치
 
 ```
-backlogs/
-└── {feature}/
-    ├── EPIC-001-xxx.md       # Epic 정의
-    ├── STORY-001-xxx.md      # Story 정의 (AC 포함)
-    └── STORY-002-xxx.md
-
-.tasks/
-└── {STORY-ID}/               # Story별 디렉토리
-    ├── index.md
-    ├── TASK-001-xxx.md
-    └── TASK-002-xxx.md
-
-test-cases/
-└── {STORY-ID}/               # Story별 디렉토리
-    ├── index.md
-    ├── TC-001-01-xxx.md
-    └── TC-001-02-xxx.md
+documents/
+├── issues/
+│   ├── epics/
+│   │   └── EPIC-001-xxx.md           # Epic 정의
+│   ├── stories/
+│   │   ├── STORY-001-xxx.md          # Story 정의 (AC 포함)
+│   │   └── STORY-002-xxx.md
+│   └── tasks/
+│       ├── TASK-001-xxx.md
+│       └── TASK-002-xxx.md
+│
+└── test/
+    ├── unit/
+    │   ├── UT-001-xxx.md             # Unit Test
+    │   └── UT-002-xxx.md
+    └── acceptance/
+        ├── AT-001-xxx.md             # Acceptance Test
+        └── AT-002-xxx.md
 ```
 
 ### 상위 참조 규칙
@@ -360,12 +361,12 @@ updated_at: 2024-01-10
 ---
 ```
 
-### TC (상위: Story)
+### Acceptance Test (상위: Story)
 
 ```yaml
 ---
-id: TC-XXX-NN
-title: [TC 제목]
+id: AT-XXX
+title: [AT 제목]
 story_id: STORY-XXX    # 상위 Story 참조
 ac_ids: [AC-1, AC-2]   # 연결된 AC
 status: ready          # ready | passed | failed | blocked
@@ -374,6 +375,19 @@ updated_at: 2024-01-10
 ---
 ```
 
+### Unit Test (상위: Task)
+
+```yaml
+---
+id: UT-XXX
+title: [UT 제목]
+task_id: TASK-XXX      # 상위 Task 참조
+status: ready          # ready | passed | failed | blocked
+created_at: 2024-01-10
+updated_at: 2024-01-10
+---
+```
+
 ---
 
 ## 출력 형식

package/templates/agents/unit-test-generator.md

@@ -92,9 +92,9 @@ color: green
 ```
 코딩 Agent가 Task 구현 시작하려고 할 때:
 
-1. Task 문서 확인 (.tasks/STORY-XXX/TASK-XXX.md)
+1. Task 문서 확인 (documents/issues/tasks/TASK-XXX.md)
 2. unit-test-generator 호출 (이 subagent)
-3. Unit Test 생성 완료
+3. Unit Test 생성 완료 (documents/test/unit/UT-XXX.md)
 4. 테스트 실행 → 실패 확인 (Red)
 5. 구현 시작
 ```
@@ -104,7 +104,7 @@ color: green
 ## 입력: Task 문서 구조
 
 ```yaml
-# .tasks/STORY-001/TASK-001-entity.md
+# documents/issues/tasks/TASK-001-entity.md
 ---
 id: TASK-001
 title: ChatRoom Entity 생성
@@ -346,7 +346,7 @@ func TestChatRoom(t *testing.T) {
 ### Step 1: Task 분석
 
 ```
-1. Task 문서 읽기 (.tasks/STORY-XXX/TASK-XXX.md)
+1. Task 문서 읽기 (documents/issues/tasks/TASK-XXX.md)
 2. Acceptance Criteria 섹션 추출
 3. Test Scenarios 섹션 추출
 4. 테스트 대상 파악 (Entity, Service, Repository 등)

package/templates/agents/workflow-navigator.md

@@ -190,20 +190,18 @@ color: cyan
 
 ```
 1. documents/ 폴더 확인
-   - documents/prd/ → PRD 존재 여부
-   - documents/hld/ → HLD 존재 여부
-   - documents/lld/ → LLD 존재 여부
-
-2. backlogs/ 폴더 확인
-   - Epic/Story 존재 여부
-   - Story 상태 (open/close)
-
-3. .tasks/ 폴더 확인
-   - Task 존재 여부
-   - Task 상태 (todo/inprogress/done)
-
-4. test-cases/ 폴더 확인
-   - TC 존재 여부
+   - documents/request/ → PRD 존재 여부
+   - documents/system-design/architecture.md → SAD 존재 여부
+   - documents/system-design/features/{feature}/ → HLD/LLD 존재 여부
+
+2. documents/issues/ 폴더 확인
+   - documents/issues/epics/ → Epic 존재 여부
+   - documents/issues/stories/ → Story 존재 여부 및 상태
+   - documents/issues/tasks/ → Task 존재 여부 및 상태
+
+3. documents/test/ 폴더 확인
+   - documents/test/unit/ → Unit Test 존재 여부
+   - documents/test/acceptance/ → Acceptance Test 존재 여부
 ```
 
 ### Step 2: 복잡도 판단

package/templates/skills/architecture-design/SKILL.md

@@ -93,7 +93,7 @@ flowchart TD
 ## Step 0: 기존 SAD 확인
 
 ```
-documents/architecture/system-architecture.md 파일이 존재하는지 확인합니다.
+documents/system-design/architecture.md 파일이 존재하는지 확인합니다.
 
 있으면 → 업데이트 모드
 없으면 → 신규 생성 모드
@@ -387,7 +387,7 @@ graph TB
 
 ## 산출물
 
-**저장 위치**: `documents/architecture/system-architecture.md`
+**저장 위치**: `documents/system-design/architecture.md`
 
 ---
 

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

@@ -278,19 +278,25 @@ Story 분해안을 검토해주세요.
 ### 출력 구조
 
 ```
-docs/
-└── issue/
-    └── {feature-name}/
-        ├── index.md                    # 전체 백로그 개요
-        ├── epic-{epic-name}.md         # Epic 개별 문서
-        ├── story-{story-name}.md       # Story 개별 문서
-        └── task-{task-name}.md         # Task 개별 문서 (task-generator)
+documents/
+└── issues/
+    ├── epics/
+    │   └── EPIC-xxx.md              # Epic 개별 문서
+    ├── stories/
+    │   └── STORY-xxx.md             # Story 개별 문서
+    └── tasks/
+        └── TASK-xxx.md              # Task 개별 문서 (task-generator)
 ```
 
 **파일명 규칙**:
-- Epic: `epic-{kebab-case-name}.md` (예: `epic-user-authentication.md`)
-- Story: `story-{kebab-case-name}.md` (예: `story-email-login.md`)
-- Task: `task-{kebab-case-name}.md` (예: `task-login-entity.md`)
+- 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`)
+
+**특징**:
+- Epic 없이 Story만 독립적으로 존재 가능
+- Story 없이 Task만 독립적으로 존재 가능
+- 각각 별도 폴더에서 독립적으로 관리
 
 ### index.md 구조
 

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

@@ -111,7 +111,7 @@ Feature HLD 작성 전 SAD와 PRD 존재 여부를 확인합니다.
 
 ### SAD 확인
 ```
-documents/architecture/system-architecture.md 파일 확인
+documents/system-design/architecture.md 파일 확인
 
 있으면 → SAD 참조하여 HLD 작성
 없으면 → SAD 없이 진행 가능 (권장: /architecture-design으로 먼저 작성)
@@ -385,14 +385,16 @@ erDiagram
 
 ## 산출물
 
-**저장 위치**: `docs/system-design/{feature-name}/hld.md`
+**저장 위치**: `documents/system-design/features/{feature-name}/hld.md`
 
 ```
-docs/
+documents/
 └── system-design/
-    └── {feature-name}/
-        ├── hld.md    ← 이 스킬로 생성
-        └── lld.md    ← lld-generator로 생성
+    ├── architecture.md           ← 전체 시스템 아키텍처 (SAD)
+    └── features/
+        └── {feature-name}/
+            ├── hld.md            ← 이 스킬로 생성
+            └── lld.md            ← lld-generator로 생성
 ```
 
 ---

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

@@ -310,14 +310,16 @@ HLD에서 추출할 정보:
 
 ## 산출물
 
-**저장 위치**: `docs/system-design/{feature-name}/lld.md`
+**저장 위치**: `documents/system-design/features/{feature-name}/lld.md`
 
 ```
-docs/
+documents/
 └── system-design/
-    └── {feature-name}/
-        ├── hld.md    ← hld-generator로 생성
-        └── lld.md    ← 이 스킬로 생성
+    ├── architecture.md           ← 전체 시스템 아키텍처 (SAD)
+    └── features/
+        └── {feature-name}/
+            ├── hld.md            ← hld-generator로 생성
+            └── lld.md            ← 이 스킬로 생성
 ```
 
 ---

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

@@ -389,13 +389,12 @@ owner: [작성자]
 
 ## 산출물
 
-**저장 위치**: `docs/specification/{feature-name}/prd.md`
+**저장 위치**: `documents/request/{feature-name}-prd.md`
 
 ```
-docs/
-└── specification/
-    └── {feature-name}/
-        └── prd.md
+documents/
+└── request/
+    └── {feature-name}-prd.md
 ```
 
 ---

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

@@ -715,19 +715,19 @@ class UserEntity(
 ## 출력 구조
 
 ```
-docs/
-└── issue/
-    └── {feature-name}/
-        ├── index.md                    # 전체 백로그 개요 (epic-story-generator)
-        ├── epic-{epic-name}.md         # Epic 문서
-        ├── story-{story-name}.md       # Story 문서
-        ├── task-{task-name}.md         # Task 개별 문서 (이 스킬)
-        └── ...
+documents/
+└── issues/
+    └── tasks/
+        └── TASK-{number}-{kebab-case-name}.md
 ```
 
 **파일명 규칙**:
-- `task-{kebab-case-name}.md` (예: `task-chatroom-entity.md`)
-- Task ID는 문서 내부 frontmatter에서 관리
+- `TASK-{number}-{kebab-case-name}.md` (예: `TASK-001-chatroom-entity.md`)
+- Task ID는 파일명에 포함
+
+**특징**:
+- Task는 Story 없이 독립적으로 존재 가능
+- 상위 Epic/Story 링크는 문서 내부 frontmatter에서 관리
 
 ---
 

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

@@ -425,26 +425,37 @@ VALUES
 ### 출력 구조
 
 ```
-docs/
-└── implementation/
-    └── {feature-name}/
-        ├── tc-{story-name}.md          # Story 레벨 TC (전체 시나리오 포함)
-        └── test-data/
-            ├── users.sql               # 테스트 데이터 SQL
-            └── mock-responses.json     # Mock 응답 데이터
+documents/
+└── test/
+    ├── unit/
+    │   └── UT-{number}-{kebab-case-name}.md       # Unit Test Case
+    └── acceptance/
+        └── AT-{number}-{kebab-case-name}.md       # Acceptance Test Case
 ```
 
 **파일명 규칙**:
-- `tc-{story-name}.md` (예: `tc-email-login.md`)
-- 1 Story = 1 TC 문서 (여러 시나리오 포함)
+- Unit Test: `UT-{number}-{kebab-case-name}.md` (예: `UT-001-user-repository.md`)
+- Acceptance Test: `AT-{number}-{kebab-case-name}.md` (예: `AT-001-email-login.md`)
+- 1 Story = 1 AT 문서 (여러 시나리오 포함)
+- Task 레벨 검증 = UT 문서
 
-### TC 문서 구조 (tc-{story-name}.md)
+### Unit Test vs Acceptance Test
+
+| 항목 | Unit Test (UT) | Acceptance Test (AT) |
+|------|---------------|---------------------|
+| 레벨 | Task 레벨 | Story 레벨 |
+| 관점 | 기술/구현 | 사용자/비즈니스 |
+| 목적 | Task 완료 검증 | Story "close" 검증 |
+| 예시 | "userId로 Entity 조회 성공" | "로그인 후 홈 이동" |
+| 저장 경로 | `documents/test/unit/` | `documents/test/acceptance/` |
+
+### Acceptance Test 문서 구조 (AT-{number}-{name}.md)
 
 ```markdown
 ---
-id: TC-{story-id}
-title: [Story 제목] Test Cases
-story: story-{story-name}.md
+id: AT-{number}
+title: [Story 제목] Acceptance Test
+story: STORY-xxx
 feature: {feature-name}
 status: ready  # draft | ready | passed | failed
 total_scenarios: N
@@ -452,14 +463,14 @@ automation_rate: X%
 created_at: YYYY-MM-DD
 ---
 
-# [TC-XXX] Test Cases for Story
+# [AT-XXX] Acceptance Test for Story
 
 ## Story 정보
 
 | 항목 | 내용 |
 |------|------|
-| Story | `docs/issue/{feature}/story-{story-name}.md` |
-| Epic | `docs/issue/{feature}/epic-{epic-name}.md` |
+| Story | `documents/issues/stories/STORY-xxx.md` |
+| Epic | `documents/issues/epics/EPIC-xxx.md` |
 | 총 시나리오 수 | N개 |
 | 자동화율 | X% |
 
@@ -467,27 +478,57 @@ created_at: YYYY-MM-DD
 
 | Story AC | AC 내용 | TC 시나리오 |
 |----------|---------|-------------|
-| AC-1 | 정상 로그인 | TC-01 |
-| AC-2 | 로그인 실패 처리 | TC-02 |
-| AC-3 | 계정 잠금 정책 | TC-03 |
+| AC-1 | 정상 로그인 | AT-01 |
+| AC-2 | 로그인 실패 처리 | AT-02 |
+| AC-3 | 계정 잠금 정책 | AT-03 |
 
 ## 시나리오 목록
 
 | ID | 제목 | 유형 | 우선순위 | 자동화 |
 |----|------|------|----------|--------|
-| TC-01 | 정상 로그인 | E2E | P0 | Yes |
-| TC-02 | 잘못된 비밀번호 | E2E | P1 | Yes |
-| TC-03 | 계정 잠금 | E2E | P1 | Yes |
+| AT-01 | 정상 로그인 | E2E | P0 | Yes |
+| AT-02 | 잘못된 비밀번호 | E2E | P1 | Yes |
+| AT-03 | 계정 잠금 | E2E | P1 | Yes |
 
 ## 실행 순서
 
-1. 데이터 초기화: `test-data/users.sql` 실행
-2. TC-01 실행 (정상 케이스 먼저)
-3. TC-02 실행
-4. TC-03 실행
+1. 데이터 초기화
+2. AT-01 실행 (정상 케이스 먼저)
+3. AT-02 실행
+4. AT-03 실행
 5. 데이터 정리
 ```
 
+### Unit Test 문서 구조 (UT-{number}-{name}.md)
+
+```markdown
+---
+id: UT-{number}
+title: [Task 제목] Unit Test
+task: TASK-xxx
+feature: {feature-name}
+status: ready  # draft | ready | passed | failed
+total_scenarios: N
+created_at: YYYY-MM-DD
+---
+
+# [UT-XXX] Unit Test for Task
+
+## Task 정보
+
+| 항목 | 내용 |
+|------|------|
+| Task | `documents/issues/tasks/TASK-xxx.md` |
+| Story | `documents/issues/stories/STORY-xxx.md` |
+
+## 테스트 시나리오
+
+| ID | 제목 | 유형 | 우선순위 |
+|----|------|------|----------|
+| UT-01 | findById 성공 | Unit | P0 |
+| UT-02 | findById 실패 - 존재하지 않음 | Unit | P1 |
+```
+
 ---
 
 ## Test Agent 연동