muno-claude-plugin 1.5.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muno-claude-plugin",
-  "version": "1.5.0",
+  "version": "1.7.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 구조
 
@@ -337,20 +343,39 @@ Total: X SP
 
 ## Epic/Story 작성 완료 후 필수 작업
 
-**중요: Epic/Story 파일 저장이 완료되면 반드시 다음을 수행합니다:**
+**중요: Epic/Story 파일 저장이 완료되면 반드시 다음 Subagent 체인을 순서대로 실행합니다:**
+
+### Step 1: 품질 검토 (필수)
+
+**Subagent**: `epic-story-reviewer`
 
-1. **epic-story-reviewer subagent 실행** (필수)
-   - Task 도구를 사용하여 `epic-story-reviewer` subagent를 실행
-   - 백로그 폴더 경로를 전달하여 품질 검토 수행
-   - 검토 결과에 따라 Epic/Story 보완
+Task 도구를 사용하여 다음과 같이 호출합니다:
 
 ```
-Epic/Story 작성이 완료되었습니다.
-품질 검토를 위해 epic-story-reviewer를 실행합니다.
+Task 도구 호출:
+- subagent_type: epic-story-reviewer
+- prompt: "다음 백로그 폴더의 Epic/Story 문서를 검토해주세요: {백로그 폴더 경로}"
 ```
 
-2. **사용자 최종 확인**
-   - 리뷰 완료 후 사용자에게 최종 검토 요청
+**다음 단계 조건**:
+- ✅ 리뷰 통과 → Step 2로 진행
+- ❌ 리뷰 실패 → 피드백 반영 후 다시 Step 1
+
+### Step 2: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+리뷰 통과 후, Task 도구를 사용하여 상태를 동기화합니다:
+
+```
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "Epic/Story 문서가 생성되었습니다. 상태를 추적해주세요: {생성된 Epic/Story 파일 목록}"
+```
+
+### Step 3: 사용자 최종 확인
+
+- 리뷰 및 상태 추적 완료 후 사용자에게 최종 검토 요청
 
 ---
 

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,34 +385,55 @@ 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로 생성
 ```
 
 ---
 
 ## HLD 작성 완료 후 필수 작업
 
-**중요: HLD 파일 저장이 완료되면 반드시 다음을 수행합니다:**
+**중요: HLD 파일 저장이 완료되면 반드시 다음 Subagent 체인을 순서대로 실행합니다:**
 
-1. **hld-reviewer subagent 실행** (필수)
-   - Task 도구를 사용하여 `hld-reviewer` subagent를 실행
-   - HLD 파일 경로를 전달하여 아키텍처 리뷰 수행
-   - 검토 결과에 따라 HLD 보완
+### Step 1: 품질 검토 (필수)
+
+**Subagent**: `hld-reviewer`
+
+Task 도구를 사용하여 다음과 같이 호출합니다:
+
+```
+Task 도구 호출:
+- subagent_type: hld-reviewer
+- prompt: "다음 HLD 문서를 검토해주세요: {HLD 파일 경로}"
+```
+
+**다음 단계 조건**:
+- ✅ 리뷰 통과 → Step 2로 진행
+- ❌ 리뷰 실패 → 피드백 반영 후 다시 Step 1
+
+### Step 2: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+리뷰 통과 후, Task 도구를 사용하여 상태를 동기화합니다:
 
 ```
-HLD 작성이 완료되었습니다.
-아키텍처 검토를 위해 hld-reviewer를 실행합니다.
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "HLD 문서가 생성되었습니다. 상태를 추적해주세요: {HLD 파일 경로}"
 ```
 
-2. **사용자 최종 확인**
-   - 리뷰 완료 후 사용자에게 최종 검토 요청
+### Step 3: 사용자 최종 확인
+
+- 리뷰 및 상태 추적 완료 후 사용자에게 최종 검토 요청
 
 ---
 

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

@@ -310,34 +310,55 @@ 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            ← 이 스킬로 생성
 ```
 
 ---
 
 ## LLD 작성 완료 후 필수 작업
 
-**중요: LLD 파일 저장이 완료되면 반드시 다음을 수행합니다:**
+**중요: LLD 파일 저장이 완료되면 반드시 다음 Subagent 체인을 순서대로 실행합니다:**
 
-1. **lld-reviewer subagent 실행** (필수)
-   - Task 도구를 사용하여 `lld-reviewer` subagent를 실행
-   - LLD 파일 경로를 전달하여 상세 설계 리뷰 수행
-   - 검토 결과에 따라 LLD 보완
+### Step 1: 품질 검토 (필수)
+
+**Subagent**: `lld-reviewer`
+
+Task 도구를 사용하여 다음과 같이 호출합니다:
+
+```
+Task 도구 호출:
+- subagent_type: lld-reviewer
+- prompt: "다음 LLD 문서를 검토해주세요: {LLD 파일 경로}"
+```
+
+**다음 단계 조건**:
+- ✅ 리뷰 통과 → Step 2로 진행
+- ❌ 리뷰 실패 → 피드백 반영 후 다시 Step 1
+
+### Step 2: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+리뷰 통과 후, Task 도구를 사용하여 상태를 동기화합니다:
 
 ```
-LLD 작성이 완료되었습니다.
-상세 설계 검토를 위해 lld-reviewer를 실행합니다.
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "LLD 문서가 생성되었습니다. 상태를 추적해주세요: {LLD 파일 경로}"
 ```
 
-2. **사용자 최종 확인**
-   - 리뷰 완료 후 사용자에게 최종 검토 요청
+### Step 3: 사용자 최종 확인
+
+- 리뷰 및 상태 추적 완료 후 사용자에게 최종 검토 요청
 
 ---
 

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

@@ -389,33 +389,51 @@ 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
 ```
 
 ---
 
 ## PRD 작성 완료 후 필수 작업
 
-**중요: PRD 파일 저장이 완료되면 반드시 다음을 수행합니다:**
+**중요: PRD 파일 저장이 완료되면 반드시 다음 Subagent 체인을 순서대로 실행합니다:**
 
-1. **prd-reviewer subagent 실행** (필수)
-   - Task 도구를 사용하여 `prd-reviewer` subagent를 실행
-   - PRD 파일 경로를 전달하여 품질 검토 수행
-   - 검토 결과에 따라 PRD 보완
+### Step 1: 품질 검토 (필수)
+
+**Subagent**: `prd-reviewer`
+
+Task 도구를 사용하여 다음과 같이 호출합니다:
+
+```
+Task 도구 호출:
+- subagent_type: prd-reviewer
+- prompt: "다음 PRD 문서를 검토해주세요: {PRD 파일 경로}"
+```
+
+**다음 단계 조건**:
+- ✅ 리뷰 통과 → Step 2로 진행
+- ❌ 리뷰 실패 → 피드백 반영 후 다시 Step 1
+
+### Step 2: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+리뷰 통과 후, Task 도구를 사용하여 상태를 동기화합니다:
 
 ```
-PRD 작성이 완료되었습니다.
-품질 검토를 위해 prd-reviewer를 실행합니다.
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "PRD 문서가 생성되었습니다. 상태를 추적해주세요: {PRD 파일 경로}"
 ```
 
-2. **사용자 최종 확인**
-   - 리뷰 완료 후 사용자에게 최종 검토 요청
+### Step 3: 사용자 최종 확인
+
+- 리뷰 및 상태 추적 완료 후 사용자에게 최종 검토 요청
 
 ---
 

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

@@ -715,19 +715,62 @@ 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-{story-id}-{seq}-{kebab-case-name}.md
 ```
 
 **파일명 규칙**:
-- `task-{kebab-case-name}.md` (예: `task-chatroom-entity.md`)
-- Task ID는 문서 내부 frontmatter에서 관리
+
+| 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` |
+
+**예시 (Story 기반)**:
+```
+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
+```
+
+**ID 규칙**:
+- `S001` = Story-001 (Story 기반)
+- `E001` = Epic-001 (Epic 기반)
+- `IND` = Independent (독립 Task)
+- `seq` = 01, 02, 03... (순번)
+
+**특징**:
+- 파일명만 보고 상위 Story/Epic 연결 파악 가능
+- 같은 Story의 Task들이 파일 탐색기에서 그룹핑됨
+- 상위 Epic/Story 링크는 문서 내부 frontmatter에서도 관리
+
+---
+
+## Task 작성 완료 후 필수 작업
+
+**중요: Task 파일 저장이 완료되면 반드시 다음 Subagent를 실행합니다:**
+
+### Step 1: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+Task 도구를 사용하여 상태를 동기화합니다:
+
+```
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "Task 문서가 생성되었습니다. 상태를 추적해주세요: {생성된 Task 파일 목록}"
+```
+
+### Step 2: 사용자 최종 확인
+
+- 상태 추적 완료 후 사용자에게 최종 검토 요청
 
 ---
 
@@ -740,6 +783,7 @@ docs/
 - `/prd-generator`: PRD 생성
 
 **Subagents**:
+- `task-tracker`: Task 생성 시 상태 추적 (자동 호출)
 - `unit-test-generator`: Task 구현 전 Unit Test 자동 생성 (TDD)
   - Task의 Acceptance Criteria 기반
   - 구현 전에 실패하는 테스트 먼저 생성

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 연동
@@ -529,20 +570,39 @@ fun `유효한 이메일과 비밀번호로 로그인 시 홈 화면으로 이
 
 ## TC 작성 완료 후 필수 작업
 
-**중요: TC 파일 저장이 완료되면 반드시 다음을 수행합니다:**
+**중요: TC 파일 저장이 완료되면 반드시 다음 Subagent 체인을 순서대로 실행합니다:**
+
+### Step 1: 품질 검토 (필수)
+
+**Subagent**: `tc-reviewer`
+
+Task 도구를 사용하여 다음과 같이 호출합니다:
 
-1. **tc-reviewer subagent 실행** (필수)
-   - Task 도구를 사용하여 `tc-reviewer` subagent를 실행
-   - TC 폴더 경로를 전달하여 품질 검토 수행
-   - 검토 결과에 따라 TC 보완
+```
+Task 도구 호출:
+- subagent_type: tc-reviewer
+- prompt: "다음 TC 문서를 검토해주세요: {TC 파일 경로}"
+```
+
+**다음 단계 조건**:
+- ✅ 리뷰 통과 → Step 2로 진행
+- ❌ 리뷰 실패 → 피드백 반영 후 다시 Step 1
+
+### Step 2: 상태 추적 (필수)
+
+**Subagent**: `task-tracker`
+
+리뷰 통과 후, Task 도구를 사용하여 상태를 동기화합니다:
 
 ```
-TC 작성이 완료되었습니다.
-품질 검토를 위해 tc-reviewer를 실행합니다.
+Task 도구 호출:
+- subagent_type: task-tracker
+- prompt: "TC 문서가 생성되었습니다. 상태를 추적해주세요: {TC 파일 경로}"
 ```
 
-2. **사용자 최종 확인**
-   - 리뷰 완료 후 사용자에게 최종 검토 요청
+### Step 3: 사용자 최종 확인
+
+- 리뷰 및 상태 추적 완료 후 사용자에게 최종 검토 요청
 
 ---