muno-claude-plugin 1.0.0

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

@@ -0,0 +1,661 @@
+---
+name: task-generator
+description: |
+  User Story를 기반으로 AI 코딩 에이전트가 바로 구현할 수 있는 Implementation Task를 생성합니다.
+  "태스크 만들어줘", "구현 스펙 작성", "스토리 보고 태스크 분해", "코딩 스펙 생성",
+  "개발 명세 작성", "TASK 생성" 등의 요청에 사용합니다.
+  코딩 에이전트가 추론 없이 정확하게 작업을 수행할 수 있도록 충분한 맥락과 참조 문서를 제공합니다.
+allowed-tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch
+---
+
+# Implementation Task Generator
+
+**User Story를 AI 코딩 에이전트가 바로 구현 가능한 Task로 변환합니다.**
+
+## 핵심 원칙
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│   Task는 "스펙"이다. "구현"이 아니다.                                         │
+│   조건과 요구사항을 정의하고, 구현은 코딩 에이전트에게 맡긴다.                  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│   • Context: 왜 이 작업이 필요한가, User Story와의 연결                       │
+│   • Document References: 참조해야 할 문서들 (LLD, HLD 등) 임포트              │
+│   • What: 정확히 무엇을 만드는가 (파일, 클래스, 메서드 시그니처)               │
+│   • Conditions: 어떤 조건을 충족해야 하는가 (데이터 정의, 비즈니스 규칙)       │
+│   • Reference: 어떤 패턴을 따라야 하는가 (기존 코드 참조)                      │
+│   • Close: 언제 완료인가 (체크리스트 형태의 Acceptance Criteria)               │
+│   • Test: 어떤 값으로 테스트하는가 (입력값과 기대 결과)                        │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+❌ Task에 포함하지 않는 것:
+   • 구현 코드 (실제 코드는 개발의 영역)
+   • 테스트 코드 (테스트 시나리오와 값만 제공)
+
+✅ Task에 포함하는 것:
+   • 조건, 요구사항, 제약사항
+   • 의사 코드 (pseudocode) 수준의 로직 설명
+   • 메서드 시그니처 (입력/출력 타입)
+   • 데이터 정의 (필드, 타입, 제약조건)
+   • 비즈니스 규칙
+```
+
+---
+
+## 페르소나
+
+@.claude/personas/dev.md
+
+---
+
+## 문서 체계 및 워크플로우
+
+```
+PRD → Epic & Story → HLD → LLD → Implementation Task (이 스킬) → Code
+                       │          │              │
+                       │          │              └── 코딩 에이전트가 실행
+                       │          │
+                       └──────────┴── Task에서 참조 (임포트)
+```
+
+### User Story → Task 관계
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  1개의 User Story = 1~N개의 Task                                            │
+├─────────────────────────────────────────────────────────────────────────────┤
+│  Story: "사용자가 채팅방을 생성할 수 있다"                                    │
+│                                                                             │
+│  └── TASK-001: ChatRoom Entity + Enum 생성                                  │
+│  └── TASK-002: ChatRoomRepository 생성                                      │
+│  └── TASK-003: ChatRoomService 생성                                         │
+│  └── TASK-004: ChatRoomController + API 생성                                │
+│  └── TASK-005: Unit/Integration Test 작성                                   │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 워크플로우
+
+```mermaid
+flowchart TD
+    A[사용자 요청] --> B{User Story 존재?}
+    B -->|No| C[Story 작성 권유]
+    B -->|Yes| D{LLD 존재?}
+    D -->|No| E[LLD 작성 권유]
+    D -->|Yes| F[Step 1: Story & LLD 분석]
+    F --> G[Step 2: 코드베이스 패턴 분석]
+    G --> H[Step 3: Task 분해 & 의존성 정의]
+    H --> I{정보 충분?}
+    I -->|No| J[보충 질문 2-3개]
+    J --> K[사용자 응답]
+    K --> I
+    I -->|Yes| L[Step 4: index.md 작성]
+    L --> M[사용자 검토]
+    M -->|수정| L
+    M -->|승인| N[Step 5: 개별 Task 작성]
+    N --> O[저장: .tasks/story-id/]
+```
+
+---
+
+## Step 0: 필수 문서 확인
+
+### User Story 확인
+
+User Story가 없으면 먼저 작성하도록 안내합니다.
+
+```
+Implementation Task 작성을 위해 User Story가 필요합니다.
+User Story가 준비되어 있으신가요?
+
+없다면 /epic-story-generator 스킬로 먼저 작성해주세요.
+```
+
+### LLD 확인
+
+LLD가 없으면 먼저 작성하도록 안내합니다.
+
+```
+Implementation Task 작성을 위해 LLD(Low-Level Design)도 필요합니다.
+LLD가 준비되어 있으신가요?
+
+없다면 /lld-generator 스킬로 먼저 작성해주세요.
+```
+
+### 수집할 문서 체크리스트
+
+| 문서 | 필수/선택 | 용도 |
+|------|----------|------|
+| User Story | **필수** | Task의 목적과 Acceptance Criteria 기준 |
+| LLD | **필수** | 구현 상세 (ERD, API Spec, 서비스 메서드) |
+| HLD | 선택 | 아키텍처 컨텍스트 (필요시 참조) |
+| Epic | 선택 | 전체 기능 맥락 (배경 설명용) |
+| PRD | 선택 | 비즈니스 요구사항 (배경 설명용) |
+
+---
+
+## Step 1: Story & LLD 분석
+
+### User Story에서 추출할 정보
+
+```markdown
+## User Story 분석 결과
+
+**Story ID**: STORY-XXX
+**제목**: [Story 제목]
+
+**User Story**:
+- AS A: [사용자 역할]
+- I WANT: [원하는 기능]
+- SO THAT: [비즈니스 가치]
+
+**Acceptance Criteria** (Story의 AC를 Task의 기준으로):
+1. [AC-1]: [조건]
+2. [AC-2]: [조건]
+...
+
+**Story Points**: X
+**우선순위**: [Must/Should/Could]
+```
+
+### LLD에서 추출할 정보
+
+- ERD + Entity 정의
+- 서비스 메서드 정의
+- API Spec (엔드포인트, Request/Response)
+- Sequence Diagram
+- Error Codes
+- FR/NFR
+
+### 질문 예시 (한 번에 2-3개)
+
+```
+User Story와 LLD를 확인했습니다. Task 분해를 위해 몇 가지 확인이 필요합니다.
+
+1. 이 Story에서 가장 핵심적인 기능은 무엇인가요?
+2. 기존 코드베이스에 유사한 패턴이 있나요? (참조할 코드)
+3. 특별히 복잡한 비즈니스 로직이 있나요?
+```
+
+---
+
+## Step 2: 코드베이스 패턴 분석
+
+기존 코드에서 유사한 구현을 찾아 참조 패턴으로 제공합니다.
+
+```kotlin
+// 분석 대상
+Glob: "**/domain/**/model/*.kt"      // Entity 패턴
+Glob: "**/domain/**/repository/*.kt" // Repository 패턴
+Glob: "**/service/**/*Service.kt"    // Service 패턴
+Glob: "**/controller/**/*.kt"        // Controller 패턴
+```
+
+**참조 선정 기준**:
+1. 가장 최근 작성된 코드 (최신 컨벤션)
+2. 유사한 도메인 (비즈니스 로직 유사)
+3. 복잡도가 비슷한 코드
+
+---
+
+## Step 3: Task 분해 & 의존성
+
+### Task 크기 가이드라인
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  • 1 Task = 1-3개 파일                                                      │
+│  • 1 Task = 코딩 에이전트가 한 세션에서 완료 가능한 크기                       │
+│  • 1 Task = 200-500 라인 (컨텍스트 효율)                                     │
+│  • 1 Task = 독립적으로 테스트 가능한 단위                                     │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 표준 분해 패턴
+
+```
+Phase 1: Domain (의존성 없음 - 병렬 가능)
+├── TASK-001: Entity + Enum
+└── TASK-002: Exception
+
+Phase 2: Repository & DTO (Phase 1 의존)
+├── TASK-003: Repository
+└── TASK-004: Command/DTO
+
+Phase 3: Service (Phase 2 의존)
+└── TASK-005: Service
+
+Phase 4: API (Phase 3 의존)
+├── TASK-006: Request/Response DTO
+├── TASK-007: Mapper
+└── TASK-008: Controller
+
+Phase 5: Test (각 Phase 완료 후)
+├── TASK-009: Service Unit Test
+└── TASK-010: API Integration Test
+```
+
+### 질문 예시 (Task 분해 확정 전)
+
+```
+Task 분해안을 검토해주세요.
+
+1. Entity와 Enum을 하나의 Task로 묶어도 될까요? 분리가 필요한가요?
+2. Service가 복잡해서 생성/조회/수정/삭제를 별도 Task로 분리할까요?
+3. 테스트는 각 레이어별로 별도 Task로 할까요, 통합으로 할까요?
+```
+
+---
+
+## Step 4: index.md 작성
+
+전체 Task 목록과 의존성을 정리합니다. [템플릿 참조](reference/impl-task-template.md)
+
+```markdown
+# [Story ID] Implementation Tasks
+
+## Story 정보
+
+| 항목 | 내용 |
+|-----|------|
+| Story ID | STORY-XXX |
+| Story 제목 | [제목] |
+| Epic | EPIC-XXX |
+| LLD 참조 | `documents/lld/xxx-lld.md` |
+
+## Task 목록
+
+| Task ID | 이름 | 상태 | 선행 Task | 생성 파일 |
+|---------|-----|------|----------|----------|
+| TASK-001 | Entity 생성 | ⬜ | - | domain/xxx/model/ |
+| TASK-002 | ... | ⬜ | TASK-001 | ... |
+
+## 의존성 그래프
+[mermaid 다이어그램]
+
+## 병렬 실행 가이드
+- Phase 1: TASK-001, TASK-002 (동시 가능)
+- Phase 2: TASK-003, TASK-004 (Phase 1 완료 후)
+...
+```
+
+---
+
+## Step 5: 개별 Task 작성
+
+### Task 필수 섹션 (7개)
+
+각 Task는 **7개 핵심 섹션**을 반드시 포함합니다:
+
+```markdown
+# TASK-XXX: [Task 이름]
+
+## 1. Context (맥락)
+왜 이 Task가 필요한가, User Story와의 연결
+
+## 2. Document References (참조 문서 임포트)
+코딩 에이전트가 참고해야 할 문서들과 핵심 내용 발췌
+
+## 3. Scope (범위)
+생성할 파일, 선행 Task, 예상 소요
+
+## 4. Reference Code (참조 코드)
+기존 코드베이스에서 따라야 할 패턴
+
+## 5. Implementation Spec (구현 명세)
+조건, 요구사항, 의사 코드 (구현 코드 X)
+
+## 6. Acceptance Criteria (완료 조건)
+체크리스트 형태의 명확한 완료 기준
+
+## 7. Test Scenarios (테스트 시나리오)
+구체적인 테스트 케이스와 값
+```
+
+---
+
+## 섹션별 작성 가이드
+
+### 1. Context (맥락) - 핵심!
+
+**코딩 에이전트가 "왜"를 이해해야 "무엇"을 올바르게 구현한다.**
+
+```markdown
+## 1. Context
+
+### 1.1 User Story 연결
+
+**Story**: STORY-XXX - [Story 제목]
+
+**AS A** [사용자 역할]
+**I WANT** [원하는 기능]
+**SO THAT** [비즈니스 가치]
+
+### 1.2 이 Task의 역할
+
+[이 Task가 전체 Story에서 담당하는 부분]
+[이 Task가 완료되면 Story의 어떤 AC가 충족되는지]
+
+### 1.3 관련 Task
+
+- **선행**: TASK-XXX (이것이 있어야 이 Task 가능)
+- **후행**: TASK-XXX (이 Task가 완료되어야 시작 가능)
+```
+
+### 2. Document References (참조 문서 임포트) - 핵심!
+
+**코딩 에이전트가 추론하지 않도록, 필요한 정보를 직접 임포트한다.**
+
+```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
+
+| 항목 | 내용 |
+|-----|------|
+| 생성 파일 | `core/.../model/Entity.kt`, `core/.../model/Enum.kt` |
+| 선행 Task | 없음 (또는 TASK-XXX) |
+| 예상 라인 | 약 150줄 |
+```
+
+### 4. Reference Code (참조 코드)
+
+```markdown
+## 4. Reference Code
+
+**참조 파일**: `core/src/main/kotlin/com/example/domain/user/model/UserEntity.kt`
+
+```kotlin
+// 기존 코드에서 따라야 할 패턴
+@Entity
+@Table(name = "users")
+class UserEntity(
+    @Column(name = "email", nullable = false)
+    var email: String,
+    // ...
+) : BaseEntity()
+```
+
+**따라야 할 패턴**:
+- [ ] BaseEntity 상속
+- [ ] @Table(name = "snake_case")
+- [ ] @Column(name = "snake_case") 명시
+```
+
+### 5. Implementation Spec (구현 명세)
+
+> **주의**: 구현 코드를 포함하지 않는다. 조건과 요구사항만 정의한다.
+
+```markdown
+## 5. Implementation Spec
+
+### 5.1 데이터 정의
+
+| 필드 | 타입 | 제약조건 | 설명 |
+|------|------|----------|------|
+| id | Long | PK, Auto | 내부 식별자 |
+| externalId | UUID | Unique, Not Null | 외부 ID (UUIDv7) |
+| userId | Long | FK, Not Null | 생성자 |
+| title | String | Not Null, Max 100 | 제목 |
+| status | Enum | Not Null, Default ACTIVE | 상태 |
+
+### 5.2 비즈니스 규칙
+
+| ID | 규칙 | 설명 |
+|----|------|------|
+| BR-01 | 기본 상태 | 생성 시 status = ACTIVE |
+| BR-02 | 제목 검증 | title은 1-100자 |
+| BR-03 | 외부 ID | UUIDv7로 자동 생성 |
+
+### 5.3 메서드 시그니처 (Service의 경우)
+
+| 메서드 | 입력 | 출력 | 설명 |
+|--------|-----|------|------|
+| create | CreateCommand | Dto | 생성 |
+| getById | UUID, Long | Dto | 조회 (권한 검증) |
+
+### 5.4 의사 코드 (복잡한 로직의 경우)
+
+```
+// updateTitle 로직
+1. externalId로 Entity 조회
+2. 요청자 userId와 Entity의 userId 비교 (권한 검증)
+3. 권한 없으면 AccessDeniedException
+4. title 유효성 검증 (1-100자)
+5. title 업데이트
+6. DTO로 변환하여 반환
+```
+```
+
+### 6. Acceptance Criteria (완료 조건)
+
+**Story의 AC에서 이 Task가 충족해야 할 부분을 명시한다.**
+
+```markdown
+## 6. Acceptance Criteria
+
+### Story AC 연결
+- [ ] Story AC-1의 "[특정 부분]"을 이 Task에서 구현
+- [ ] Story AC-2의 "[특정 부분]"을 이 Task에서 구현
+
+### 기술적 완료 조건
+- [ ] 패키지가 `com.example.domain.xxx.model`인가?
+- [ ] BaseEntity를 상속하는가?
+- [ ] 모든 @Column에 name 속성이 있는가?
+
+### 컴파일/실행 조건
+- [ ] `./gradlew compileKotlin` 성공
+- [ ] `./gradlew test` 기존 테스트 통과
+```
+
+### 7. Test Scenarios (테스트 시나리오)
+
+> **주의**: 테스트 코드를 포함하지 않는다. 시나리오와 입출력 값만 정의한다.
+
+```markdown
+## 7. Test Scenarios
+
+### 7.1 Happy Path
+
+**Story AC 연결**: Story AC-1 "정상적으로 생성"
+
+| 시나리오 | 정상적인 Entity 생성 |
+|---------|---------------------|
+
+| 입력 | 값 |
+|------|-----|
+| userId | 1L |
+| title | "테스트 제목" |
+
+| 기대 결과 | 값 |
+|----------|-----|
+| id | Auto generated (> 0) |
+| externalId | Not null (UUID v7) |
+| status | ACTIVE |
+| createdAt | 현재 시간 |
+
+### 7.2 Edge Cases
+
+**Story AC 연결**: Story AC-2 "유효성 검증"
+
+| 시나리오 | 입력 | 기대 결과 |
+|---------|------|----------|
+| 빈 제목 | title = "" | IllegalArgumentException |
+| 100자 초과 | title = "가" × 101 | IllegalArgumentException |
+| null userId | userId = null | NullPointerException (컴파일 타임) |
+
+### 7.3 권한 검증 (해당시)
+
+| 시나리오 | 조건 | 기대 결과 |
+|---------|------|----------|
+| 타인 접근 | chatRoom.userId ≠ requestUserId | AccessDeniedException |
+| 본인 접근 | chatRoom.userId = requestUserId | 정상 처리 |
+
+### 7.4 검증 쿼리 (DB 확인용)
+
+- 생성 확인: `SELECT * FROM [table] WHERE external_id = ?`
+- 인덱스 확인: `SHOW INDEX FROM [table]`
+```
+
+---
+
+## 금지 사항
+
+### ❌ 절대 하지 말 것
+
+1. **구현 코드 포함**
+   ```
+   ❌ Task에 실제 구현 코드 작성
+   ✅ 조건, 요구사항, 의사 코드만 작성
+   → 구현은 개발의 영역이다
+   ```
+
+2. **테스트 코드 포함**
+   ```
+   ❌ Task에 @Test 코드 작성
+   ✅ 테스트 시나리오와 입출력 값만 작성
+   → 테스트 코드는 테스트 Task에서 작성
+   ```
+
+3. **User Story 없이 Task 작성**
+   ```
+   ❌ "Entity 만들어줘" → 바로 작성
+   ✅ "User Story가 있나요?" → Story 분석 후 작성
+   ```
+
+4. **LLD 없이 Task 작성**
+   ```
+   ❌ Story만 보고 구현 명세 작성
+   ✅ LLD의 ERD, API Spec 참조하여 작성
+   ```
+
+5. **모호한 완료 조건**
+   ```
+   ❌ "적절히 구현되어야 함", "필요 시 처리"
+   ✅ "title 필드가 100자를 초과하면 IllegalArgumentException 발생"
+   ```
+
+6. **테스트 값 없는 시나리오**
+   ```
+   ❌ "정상 케이스 테스트"
+   ✅ "userId=1L, title='테스트' 입력 → status=ACTIVE, externalId=not null"
+   ```
+
+7. **Document References 섹션 누락**
+   ```
+   ❌ Task에 참조 문서 경로만 있음
+   ✅ 참조 문서의 핵심 내용을 직접 임포트
+   ```
+
+8. **Story AC와 연결 없는 Task AC**
+   ```
+   ❌ Task AC가 Story AC와 무관
+   ✅ Task AC가 Story의 어떤 AC를 충족하는지 명시
+   ```
+
+---
+
+## 출력 구조
+
+```
+.tasks/
+└── STORY-XXX-[story-name]/
+    ├── index.md              # 전체 개요 + Task 목록
+    ├── TASK-001-entity.md
+    ├── TASK-002-exception.md
+    ├── TASK-003-repository.md
+    └── ...
+```
+
+---
+
+## 관련 스킬 및 에이전트
+
+**Skills**:
+- `/epic-story-generator`: Epic & Story 생성 (Task 작성 전 필수)
+- `/lld-generator`: LLD 생성 (Task 작성 전 필수)
+- `/hld-generator`: HLD 생성
+- `/prd-generator`: PRD 생성
+
+**Subagents**:
+- `unit-test-generator`: Task 구현 전 Unit Test 자동 생성 (TDD)
+  - Task의 Acceptance Criteria 기반
+  - 구현 전에 실패하는 테스트 먼저 생성
+
+---
+
+## 상세 템플릿
+
+[impl-task-template.md](reference/impl-task-template.md) 참조
+
+---
+
+## 체크리스트
+
+### 문서 준비 확인
+- [ ] User Story가 있는가?
+- [ ] User Story에 Acceptance Criteria가 있는가?
+- [ ] LLD가 있는가?
+- [ ] LLD에 ERD, 서비스 메서드, API Spec이 있는가?
+
+### Task 작성 완료 확인
+- [ ] 모든 Task에 Document References 섹션이 있는가?
+- [ ] Story AC와 Task AC가 연결되어 있는가?
+- [ ] 테스트 시나리오에 구체적인 값이 있는가?
+- [ ] 코딩 에이전트가 추론 없이 실행할 수 있는가?