/zenhub:epic {feature_name} {entity_name} [--options]

// 1. Repository ID + Pipeline ID
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
const repoId = workspace.repositories.find(r = >   /* GitHub 레포 선택 */).id;

// 2. Issue Type ID
const issueTypes = await mcp__zenhub__getIssueTypes();
const epicTypeId = issueTypes.find(t = >   t.name ===  " Epic " ).id;
const featureTypeId = issueTypes.find(t = >   t.name ===  " Feature " ).id;
const subtaskTypeId = issueTypes.find(t = >   t.name ===  " Sub-task " ).id;

# Specify individual files
--images  " list.png,detail.png,form.png " 

 # Specify directory (auto-filter supported formats)
--images-dir ./screenshots/

entity:
  name: {EntityName}
  fields:
    - name: title
      type: String
      required: true
      ui_component: TextField
      validation:
        max_length: 100
      source_screen: form.png

    - name: content
      type: String
      required: true
      ui_component: TextArea
      validation:
        max_length: 5000
      source_screen: form.png

    - name: category
      type:  " {EntityName}Category " 
       required: true
      ui_component: Dropdown
      options: [general, notice, event]
      source_screen: form.png

    - name: imageUrls
      type:  " List < String > ? " 
       required: false
      ui_component: ImagePicker
      validation:
        max_count: 5
      source_screen: form.png

# {Feature} Requirements Specification

 >   Auto-generated from image analysis

## Entity Definition

### {Entity}
| Field | Type | Required | Description |
|------|------|------|------|
| title | String | ✅ | Title |
| content | String | ✅ | Content |
...

## Screen Definition

### 1. List Screen (list.png)
- Components: AppBar, ListView, FAB
- Actions: Card tap → navigate to detail, FAB tap → create
...

🖼️ 이미지를 repo에 commit하시겠습니까?

- 대상 파일: list.png, detail.png, form.png
- 저장 경로: claudedocs/{feature}/screenshots/
- 현재 브랜치: {current_branch}

**계속하시겠습니까? (y/N)**

# 1. Copy images to claudedocs
cp {input_images} claudedocs/{feature}/screenshots/

# 2. Add to Git (current branch)
git add claudedocs/{feature}/screenshots/
git commit -m  " docs: 📸 {feature} 스크린샷 추가 " 
 git push origin HEAD

# 3. Generate GitHub raw URLs
# https://raw.githubusercontent.com/{owner}/{repo}/{branch}/claudedocs/{feature}/screenshots/{image}

## 📸 이미지 분석 결과

### 식별된 화면
| # | 이미지 | 화면 타입 | 컴포넌트 수 |
|---|--------|----------|-----------|
| 1 | list.png | List | 5 |
| 2 | detail.png | Detail | 4 |
| 3 | form.png | Form | 6 |

### 추출된 Entity 필드
| 필드 | 타입 | 필수 | 출처 |
|------|------|------|------|
| title | String | ✅ | form.png |
| content | String | ✅ | form.png |
| category | Enum | ✅ | form.png |

### 생성할 BDD 시나리오
- 목록: 8개
- 상세: 6개
- 폼: 7개

**분석 결과가 정확합니까? (Y/n)**

## 요구사항 로드

1. claudedocs/{feature}/requirements.md 읽기
2. BDD 시나리오 파일들 읽기 (있는 경우)
3. Entity 필드 정의 추출
4. 화면 정의 추출

mcp__zenhub__createZenhubIssue({
  title:  " {feature} 기능 구현 " ,
  body:  " {epic_body_template} " ,
  repositoryId: repoId,      // getWorkspacePipelinesAndRepositories()에서 조회
  issueTypeId: epicTypeId,   // getIssueTypes()에서 조회
  labels: [ " epic " ,  " feature " ,  " {feature_name} " ]
})

## Epic 생성 확인

**제목**: {feature} 기능 구현

**내용 미리보기**:
---
# Epic: {Feature} 기능 구현

## 📋 개요
{feature_description}

## 💼 비즈니스 가치
**사용자로서**, {capability}을(를) 원합니다.
**그래서** {value}을(를) 얻을 수 있습니다.

## 📊 범위
- ✅ 목록 화면
- ✅ 상세 화면
- ✅ 폼 화면

## 🛠️ 기술 노트
| 항목 | 값 |
|------|-----|
| Entity | `{EntityName}` |
| Backend | Serverpod endpoint |
| Caching | SWR |
---

**라벨**: epic, feature, {feature_name}, petmedi

**생성하시겠습니까? (Y/n)**

mcp__zenhub__createZenhubIssue({
  title:  " {feature} {screen} 화면 " ,
  body:  " {story_body_template} " ,
  repositoryId: repoId,         // getWorkspacePipelinesAndRepositories()에서 조회
  issueTypeId: featureTypeId,   // getIssueTypes()에서 조회
  parentIssueId:  " {epic_id} " ,                                    // Epic과 연결
  labels: [ " story " ,  " {feature_name} " ,  " {screen_type}-view " ]
})

## Story 생성

| # | Screen | Title | Point | Acceptance Criteria Count |
|---|------|------|-------|-------|
| 1 | List | {feature} 목록 화면 | 3 | 8 |
| 2 | Detail | {feature} 상세 화면 | 3 | 9 |
| 3 | Form | {feature} 폼 화면 | 5 | 10 |

**Total Stories**: 3
**Total Points**: 11

mcp__zenhub__createZenhubIssue({
  title:  " [{PREFIX}-00X-0Y] {task_description} " ,
  body:  " {subtask_body} " ,
  repositoryId: repoId,         // getWorkspacePipelinesAndRepositories()에서 조회
  issueTypeId: subtaskTypeId,   // getIssueTypes()에서 조회
  parentIssueId:  " {story_id} " ,                                   // Story와 연결
  labels: [ " subtask " ,  " {feature_name} " ,  " p{priority} " ]
})

## 연결 완료

✅ Epic #{epic_number} 생성 완료
✅ Story #{story_1} 연결됨
✅ Story #{story_2} 연결됨
✅ Story #{story_3} 연결됨

### 생성된 이슈 링크
- Epic: https://github.com/cocode/petmedi/issues/{epic_number}
- 목록: https://github.com/cocode/petmedi/issues/{story_1}
- 상세: https://github.com/cocode/petmedi/issues/{story_2}
- 폼: https://github.com/cocode/petmedi/issues/{story_3}

claudedocs/{feature_name}/
├── screenshots/              # 이미지 분석 시 저장 (--images 사용 시)
│   ├── list.png
│   ├── detail.png
│   └── form.png
├── image_analysis.md         # 이미지 분석 결과 (--images 사용 시)
├── requirements.md           # 요구사항 (자동 생성 또는 기존 파일)
├── bdd/                      # BDD 시나리오 (자동 생성)
│   ├── {feature}_list.feature
│   ├── {feature}_detail.feature
│   └── {feature}_form.feature
└── zenhub/
    ├── epic.md               # Epic 상세 정보
    └── stories/
        ├── list_story.md     # 목록 Story 정보
        ├── detail_story.md   # 상세 Story 정보
        └── form_story.md     # 폼 Story 정보

# Epic: {Feature} 기능 구현

## 📋 개요
{Feature에 대한 간략한 설명}

## 💼 비즈니스 가치
**사용자로서**, {feature_capability}을(를) 원합니다.
**그래서** {business_value}을(를) 얻을 수 있습니다.

## 📊 범위

### 포함
- ✅ {screen_1} 화면
- ✅ {screen_2} 화면
- ✅ {screen_3} 화면

### 제외
- ❌ (필요시 명시)

## 🛠️ 기술 노트
| 항목 | 값 |
|------|-----|
| Entity | `{EntityName}` |
| Backend | Serverpod endpoint |
| Caching | {SWR / Cache-First} |
| Location | `feature/{location}/{feature_name}` |

## 🎨 디자인 스크린샷

 >   `--images` 사용 시 자동 생성됨

### 목록 화면
![목록 화면](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/claudedocs/{feature}/screenshots/list.png)

### 상세 화면
![상세 화면](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/claudedocs/{feature}/screenshots/detail.png)

### 폼 화면
![폼 화면](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/claudedocs/{feature}/screenshots/form.png)

 >   또는 Figma 링크: {figma_urls}

## 📎 관련 Story
- [ ] #{story_1_number} - 목록 화면
- [ ] #{story_2_number} - 상세 화면
- [ ] #{story_3_number} - 폼 화면

---
 >   🤖 Generated by `/zenhub:epic`

# Story: {Screen Name}

## 📋 사용자 스토리
**{user_type}로서**, {screen_capability}을(를) 원합니다.
**그래서** {value}을(를) 얻을 수 있습니다.

## ✅ 인수 기준 (Acceptance Criteria)

### AC1: {scenario_1_name}

- **Priority**: {High/Medium/Low}
- **Tag**: @{tag}

### AC2: {scenario_2_name}

- **Priority**: {High/Medium/Low}
- **Tag**: @{tag}

## 🛠️ 기술 작업

### Backend
- [ ] Serverpod endpoint 구현
- [ ] DTO 정의

### Domain
- [ ] Entity 정의
- [ ] Repository Interface 정의
- [ ] UseCase 구현
- [ ] UseCase 테스트 작성

### Data
- [ ] Repository 구현
- [ ] Serverpod Mixin 구현
- [ ] 캐싱 전략 적용

### Presentation
- [ ] BLoC 구현 (Event/State)
- [ ] Page 위젯 구현
- [ ] Widget 컴포넌트 구현
- [ ] Route 등록
- [ ] BDD 테스트 작성

### Widgetbook
- [ ] Component story 추가

## 🎨 디자인 참조

 >   `--images` 사용 시 자동 생성됨

![{screen_name}](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/claudedocs/{feature}/screenshots/{screen}.png)

 >   또는 Figma 링크: {figma_link}

## 📐 예상 Story Point
{point_value}

---
 >   🤖 Generated by `/zenhub:epic`
 >   📎 Epic: #{epic_number}

/zenhub:epic community Post

/zenhub:epic community Post \
  --requirements claudedocs/community/requirements.md \
  --bdd-dir claudedocs/community/bdd/

/zenhub:epic community Post \
  --labels  " sprint-1,mvp "   \
  --sprint current

/zenhub:epic community Post \
  --screens  " list,detail,form "   \
  --points  " 5,3,8 "

/zenhub:epic community Post \
  --images  " list.png,detail.png,form.png "

/zenhub:epic community Post \
  --images-dir ./screenshots/community/

/zenhub:epic community Post \
  --images  " list.png,detail.png,form.png "   \
  --labels  " sprint-1,mvp "   \
  --sprint current

/zenhub:epic community Post \
  --images  " list.png,detail.png,form.png "   \
  --attach-images false