/cc-dev:zenhub:breakdown {feature_name} {entity_name} [--options]

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

// 2. Issue Type ID (includes hierarchy level: lower = higher level)
const issueTypes = await mcp__zenhub__getIssueTypes({ repositoryId: repoId });
const initiativeType = issueTypes.find(t = >   t.name ===  " Initiative " );  // may be absent
const projectType = issueTypes.find(t = >   t.name ===  " Project " );  // may be absent
const epicTypeId = issueTypes.find(t = >   t.name ===  " Epic " ).id;
const featureTypeId = issueTypes.find(t = >   t.name ===  " Feature " ).id;
const bugTypeId = issueTypes.find(t = >   t.name ===  " Bug " ).id;
const taskTypeId = issueTypes.find(t = >   t.name ===  " Task " ).id;
const subtaskTypeId = issueTypes.find(t = >   t.name ===  " Sub-task " ).id;

// Initiative type fallback: if --initiative given but type absent,
// warn the user and create the Project (or Epic, if no --project) as top level instead
if (useInitiativeLevel  & &   !initiativeType) {
  // ⚠️  " 이 워크스페이스에는 Initiative Issue Type이 없습니다. Project(또는 Epic)를 최상위로 생성합니다. " 
 }

// Project type fallback: if --project given but type absent,
// warn the user and create Epic(s) as top level instead
if (useProjectLevel  & &   !projectType) {
  // ⚠️  " 이 워크스페이스에는 Project Issue Type이 없습니다. Epic을 최상위로 생성합니다. " 
 }

# 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
- 저장 경로: .claude/docs/{feature}/screenshots/
- 현재 브랜치: {current_branch}

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

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

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

# 3. Generate GitHub raw URLs
# https://raw.githubusercontent.com/{owner}/{repo}/{branch}/.claude/docs/{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. .claude/docs/{feature}/requirements.md 읽기
2. BDD 시나리오 파일들 읽기 (있는 경우)
3. Entity 필드 정의 추출
4. 화면 정의 추출

## 📐 계층 스케일 추론 결과

**판단**: Project → Epic → Feature ×3 (근거: auth/community/payment 3개 기능 도메인 언급)

**이 계층으로 진행하시겠습니까? (Y/n)**

## 🔢 우선순위 검토 결과

| 순위 | 이슈 | 티어 | impact | Point | 선행(의존) | 근거 |
|------|------|------|--------|-------|-----------|------|
| 1 | {feature} 목록 화면 | P0 | high | 3 | — | 상세/폼 화면이 목록 Entity에 의존(value+dependency 높음) |
| 2 | {feature} 상세 화면 | P1 | med | 5 | #1 | 핵심 경로, 목록 Entity 사용 |
| 3 | {feature} 폼 화면 | P1 | low | 5 | #1 | 핵심 경로 |

**이 우선순위로 진행하시겠습니까? (Y/n)**

// 1) Split per the contract table — narrative out, contract block stays
const { contract, narrative } = splitBody(item);   // SoT: rules/zenhub-conventions.md

// 2) Write the narrative to a per-issue fixed path (same path on re-publish = same URL)
const filePath = `.claude/docs/${scope}/issue-${slug}.html`;

// 3) Publish → capture the URL
const url = await Artifact({ file_path: filePath, favicon, description });

// 4) Assemble the body: contract block + link block
const body = buildBody(contract, url);

## 📄 아티팩트 발행 결과

| 이슈 | 아티팩트 | 비고 |
|------|----------|------|
| Project: {project_title} | ✅ 발행 | {url} |
| Epic: {epic_title} | ✅ 발행 | {url} |
| {feature} 목록 화면 | — | 서술 12행 (20행 이하 → 본문 유지) |
| {feature} 상세 화면 | ✅ 발행 | {url} |
| Sub-task ×5 | — | 규약상 발행 대상 아님 |

 >   🔒 발행된 링크는 비공개입니다 — 팀 열람이 필요하면 claude.ai 에서 공유를 켜주세요.

const initiative = await mcp__zenhub__createGitHubIssue({
  title:  " {initiative_title} " ,
  body: buildBody(contract, artifactUrl.initiative),  // 📄 링크 + 계약 블록 (전략 서술은 아티팩트)
  repositoryId: repoId,
  issueTypeId: initiativeType.id,
  labels: [ " initiative " ,  " p{priority} " ]
});

const project = await mcp__zenhub__createGitHubIssue({
  title:  " {project_title} " ,
  body: buildBody(contract, artifactUrl.project),  // 📄 링크 + 계약 블록 (우선순위 표는 본문 유지)
  repositoryId: repoId,
  issueTypeId: projectType.id,
  parentIssueId: initiative?.id, // when --initiative/--parent-initiative is used
  labels: [ " project " ,  " p{priority} " ]
});

mcp__zenhub__createGitHubIssue({
  title:  " {feature} 기능 구현 " ,
  body: buildBody(contract, artifactUrl.epic),  // 📄 링크 + 계약 블록 (Step 1.65 발행분)
  repositoryId: repoId,      // getWorkspacePipelinesAndRepositories()에서 조회
  issueTypeId: epicTypeId,   // getIssueTypes()에서 조회
  parentIssueId: project?.id ?? initiative?.id, // --project/--parent-project 우선, 없으면 --initiative/--parent-initiative 직접 연결
  labels: [ " epic " ,  " feature " ,  " {feature_name} " ,  " p{priority} " ]
})

// 0) Story Point — ALWAYS, for every Epic in the batch, independent of --no-dates/--sprint.
//    SoT: rules/zenhub-conventions.md →  " Mandatory Story Point Estimate " 
 for (const epic of epicsInThisBatch) {
  epic.points = epic.childStories?.length
    ? epic.childStories.reduce((s, x) = >   s + x.point, 0)        // 같은 실행에서 Story까지 만든 경우: 롤업
    : options.points?.[epic.key] ?? estimateTshirtFibonacci(epic.scopeText); // 없으면 하향식 추정 — 0/null 금지
  await mcp__zenhub__setIssueEstimate({ issueId: epic.id, estimate: epic.points });
}

// 1) Organization ID (required by setDatesForIssue)
const orgId = workspace.zenhubOrganization.id;

// 2) 킥오프 시작일 — 명시 플래그  >   --sprint 셀렉터 스프린트 시작  >   오늘
//    ⚠️ getUpcomingSprint 는  ' 다음 '   스프린트다. 기본값으로 쓰면 Epic 바가 한 스프린트 밀린다.
//       기본(current)은 getSprint()(id 없음=활성)를 쓴다.
const kickoffSprint = options.sprint ===  " next " 
   ? await mcp__zenhub__getUpcomingSprint()
  : await mcp__zenhub__getSprint();
const kickoffStart =
  options.startDate ??
  kickoffSprint?.startAt?.slice(0, 10) ??
  todayISO();                                              //  " YYYY-MM-DD " 

 if (!options.noDates) {
  // 3) 팀 실측 속도 — 고정 상수(이전: ~5pt≈2주) 대체.
  //    SoT: rules/zenhub-conventions.md →  " Epic Velocity Calculation " 
   const velocity = options.velocity
    ? { velocityPerSprint: options.velocity, sprintLengthWeeks: 2, declining: false, avgCoverage: null }
    : await computeVelocity();
  if (velocity.reason ===  " insufficient_history " ) {
    log( " ℹ️ 완료 스프린트 데이터 부족 — 고정 폴백(Epic당 1스프린트)으로 진행 " );
  }
  if (velocity.avgCoverage != null  & &   velocity.avgCoverage  <   0.5) {
    log(`⚠️ 완료 이슈 중 포인트가 매겨진 비율 ${Math.round(velocity.avgCoverage * 100)}% — 속도는 하한값에 가깝습니다`);
  }
  if (velocity.declining) {
    log( " ⚠️ 최근 3개 스프린트 평균이 전체 평균보다 낮음(하락 추세) — 보수적 속도 적용 " );
  }

  // 4) 의존 그래프 — 명시(--epic-deps)  >   요구사항 텍스트/범위 신호 추론  >   기본 독립(병렬 후보).
  //    SoT: rules/zenhub-conventions.md →  " Epic Dependency  &   Parallel Scheduling " 
   const dependencyEdges = resolveEpicDependencies(epicsInThisBatch, options.epicDeps, requirementsText);
  for (const { blocked, blocking } of dependencyEdges) {
    await mcp__zenhub__createBlockage({ blockedIssueId: blocked.id, blockingIssueId: blocking.id });
  }

  // 5) 위상 레벨로 시작/종료일 계산 — 의존 없는 Epic끼리는 같은 시작일(병렬),
  //    의존이 있으면 선행 Epic 종료 뒤. options.duration/endDate 는 단일-Epic(scale=epic) 오버라이드로 우선 적용.
  const schedule = (options.duration || options.endDate)  & &   epicsInThisBatch.length === 1
    ? [{
        epic: epicsInThisBatch[0],
        start: kickoffStart,
        end: options.endDate ?? addWeeksISO(kickoffStart, options.duration),
      }]
    : scheduleEpics(epicsInThisBatch, dependencyEdges, kickoffStart, velocity.velocityPerSprint, velocity.sprintLengthWeeks);

  // 6) 실제 반영
  for (const { epic, start, end } of schedule) {
    await mcp__zenhub__setDatesForIssue({ issueId: epic.id, startDate: start, endDate: end, zenhubOrganizationId: orgId });
    epic.scheduledStart = start;
    epic.scheduledEnd = end;
  }
}

## Epic 생성 확인

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

**내용 미리보기** (본문 = 계약 블록 + 아티팩트 링크, H1 은 타입 단어 없이 제목만 — `rules/zenhub-conventions.md` → *Unified Issue Body Template*):
---
# {Feature} 기능 구현

## 📄 상세 기획
**{artifact_url}**

↳ 개요 · 비즈니스 가치 · 기술 노트 · 화면 설계

 >   🔒 이 아티팩트 링크는 발행 시점에 **비공개**입니다. 팀이 열어야 하면 claude.ai
 >   아티팩트 페이지의 공유 메뉴에서 직접 공유를 켜주세요.

## 🔢 우선순위
| 순위 | 이슈 | 티어 | impact | 근거 |
|------|------|------|--------|------|
| 1 | {feature} 목록 화면 | P0 | high | 상세/폼이 목록 Entity에 의존 |

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

 >   개요·비즈니스 가치·기술 노트는 아티팩트로 이동했습니다 — 우선순위 표와 범위는
 >   규약상 본문에 남습니다(`rules/zenhub-conventions.md` → *Issue Body Artifact Contract*).
 >   `Artifact` 도구가 없는 세션이면 위 링크 블록 없이 종전 전량 마크다운으로 표시됩니다.

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

**📅 타임라인**: {start_date} ~ {end_date} ({weeks}주)  ← Goals  &   Planning 로드맵에 표시됨
**📐 Story Point**: {total_points}

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

## Epic 생성 확인 (다중 Epic — Project: {project_title})

**팀 속도**: 최근 6스프린트 평균 {allAvg}pt/스프린트, 최근 3스프린트 평균 {recentAvg}pt/스프린트{declining ?  "   (⚠️ 하락 추세 → 보수치 적용) "   :  " " }
**포인트 커버리지**: 완료 이슈 중 {coveragePct}%에 실제 포인트가 매겨져 있음{coveragePct  <   50 ?  "   (⚠️ 속도는 하한값에 가까움) "   :  " " }

| Epic | 티어 | Point | 의존(선행) | 시작 | 종료 | 병렬 그룹 |
|------|------|-------|-----------|------|------|-----------|
| #1 정산 엔진 API | P0 | 13 | — | 8/23 | 9/6 | A |
| #2 정산 배치 | P0 | 8 | #1 | 9/6 | 9/13 | B |
| #3 정산 리포트 UI | P1 | 8 | #1 | 9/6 | 9/13 | B |
| #4 알림 발송 | P2 | 5 | — | 8/23 | 8/30 | A |

 >   " 병렬 그룹 " 이 같은 행끼리는 시작일이 같습니다(서로 의존이 없어 동시 진행 가능하다고 판단됨).
 >   의존이 있는 행은 선행 Epic 종료일 이후에 시작합니다. 의존 관계가 틀렸다면 `--epic-deps` 로
 >   직접 지정해 다시 실행하세요.

**이 스케줄로 진행하시겠습니까? (Y/n)**

function resolveWorkItemType(item) {
  if (/fix|bug|error|수정|버그|오류/i.test(item.description)) return bugTypeId;
  if (/refactor|improve|optimize|config|build|개선|리팩토링|최적화|설정|빌드/i.test(item.description)) return taskTypeId;
  return featureTypeId; // default: add/implement/create/screen
}

mcp__zenhub__createGitHubIssue({
  title:  " {feature} {screen} 화면 " ,          // Feature example; Bug/Task use fix:/chore: prefix
  body: buildBody(contract, artifactUrl[item.key]),  // 서술 20행 초과분만 아티팩트 — 그 외 전량 마크다운
                                             // 계약 블록(AC·범위·DoD)은 항상 본문에 남는다
  repositoryId: repoId,         // getWorkspacePipelinesAndRepositories()에서 조회
  issueTypeId: resolveWorkItemType(item),   // Feature/Bug/Task — getIssueTypes()에서 조회한 값 중 실제 판정
  parentIssueId:  " {epic_id} " ,                                    // Epic과 연결 (scale=no-epic이면 생략 또는 Project/Initiative id)
  labels: [ " {feature|bug|task} " ,  " {feature_name} " ,  " {screen_type}-view " ,  " p{priority} " ,  " impact-{impact} " ]  // impact: high|med|low (Matrix Y축, C6)
})

// effort 축: Story Point 설정 (Matrix X축) — 필수, --sprint 미지정이어도 항상 호출
// (rules/zenhub-conventions.md →  " Mandatory Story Point Estimate " ; item.point 는 Step 1.6 에서 확정된 값)
await mcp__zenhub__setIssueEstimate({ issueId: item.id, estimate: item.point });

// ⚠️ 타임라인: setDatesForIssue 는 상위 타입(Epic/Project) 전용이므로 레벨4 항목에는 쓰지 않는다(off-spec).
//   Roadmap Visibility Contract(rules/zenhub-conventions.md)대로 레벨4는 **스프린트 멤버십**으로 노출한다 —
//   --sprint 가 주어지면 Step 5 에서 addIssuesToSprints 로 해당 스프린트 레인에 올린다.
//   즉 레벨4 항목의 로드맵 가시성 = 부모 Epic 의 기간 바 + 자신의 스프린트 레인.

## Work Item 생성

| # | Type | Screen/Title | Point | Timeline | Acceptance Criteria Count |
|---|------|------|-------|----------|-------|
| 1 | Feature | {feature} 목록 화면 | 3 | {s1_start}~{s1_end} | 8 |
| 2 | Feature | {feature} 상세 화면 | 3 | {s2_start}~{s2_end} | 9 |
| 3 | Feature | {feature} 폼 화면 | 5 | {s3_start}~{s3_end} | 10 |

**Total Work Items**: 3
**Total Points**: 11
**Epic Timeline**: {epic_start} ~ {epic_end}

mcp__zenhub__createGitHubIssue({
  title:  " [{PREFIX}-00X-0Y] {task_description} " ,
  body:  " {subtask_body} " ,
  repositoryId: repoId,         // getWorkspacePipelinesAndRepositories()에서 조회
  issueTypeId: subtaskTypeId,   // getIssueTypes()에서 조회
  parentIssueId:  " {work_item_id} " ,                               // 부모 work item과 연결
  labels: [ " subtask " ,  " {feature_name} " ,  " p{priority} " ]
})

## 연결 완료

✅ Project #{project_number} 생성 완료 (추론 또는 --project 사용 시)
✅ Epic #{epic_number} 생성 완료 (Project에 연결됨, scale=no-epic이면 생략)
✅ Feature #{item_1} 연결됨
✅ Feature #{item_2} 연결됨
✅ Feature #{item_3} 연결됨

### 생성된 이슈 링크
- Project: https://github.com/cocode/kobic/issues/{project_number}
- Epic: https://github.com/cocode/kobic/issues/{epic_number}
- 목록: https://github.com/cocode/kobic/issues/{item_1}
- 상세: https://github.com/cocode/kobic/issues/{item_2}
- 폼: https://github.com/cocode/kobic/issues/{item_3}

// fail-closed 해석: 이름이 라이브 파이프라인과 다르면 throw (부분 배치 후 무음 중단 방지)
const pipelineByName = (name) = >   {
  const p = workspace.pipelines.find(p = >   p.name === name);
  if (!p) throw new Error(`파이프라인  ' ${name} '   없음. 라이브: ${workspace.pipelines.map(p = >   p.name).join( " ,  " )}`);
  return p;
};
const backlog = pipelineByName( " Product Backlog " );
const sprintBacklog = pipelineByName( " Sprint Backlog " );
const icebox = pipelineByName( " Icebox " );

// ⚠️ moveIssueToPipeline has no position param —
// move in DESCENDING priority order (P0 first) to approximate top-to-bottom ordering
for (const issue of issuesSortedByPriority) {
  await mcp__zenhub__moveIssueToPipeline({
    issueId: issue.id,
    pipelineId: pipelineFor(issue),  // matrix above
  });
}

// --sprint 사용 시 P0 work item을 해당 스프린트에 추가
if (options.sprint) {
  // 셀렉터 (rules/zenhub-conventions.md →  " Sprint Selector Resolution "   와 동일 규칙):
  //   current → 활성(getSprint, id 없음) · next → 다음(getUpcomingSprint) · 숫자/이름 → listRecentSprints 매칭
  const targetSprint =
    options.sprint ===  " next "      ? await mcp__zenhub__getUpcomingSprint() :
    options.sprint ===  " current "   ? await mcp__zenhub__getSprint()         :
    (await mcp__zenhub__listRecentSprints()).openSprints
      .find(s = >   s.name.includes(String(options.sprint)));
  if (!targetSprint?.id) throw new Error(`스프린트  ' ${options.sprint} '   해석 실패 — current/next/번호를 확인하라`);
  await mcp__zenhub__addIssuesToSprints({
    issueIds: p0WorkItemIds,
    sprintIds: [targetSprint.id],
  });
}

## 파이프라인 정렬 완료

| 이슈 | 티어 | 파이프라인 |
|------|------|-----------|
| Epic #{epic_number} | — | Product Backlog |
| #{item_1} 목록 화면 | P0 | Sprint Backlog (Sprint 12) |
| #{item_2} 상세 화면 | P1 | Product Backlog |
| #{item_3} 폼 화면 | P1 | Product Backlog |

 >   파이프라인 내 세부 순서는 MCP가 지원하지 않습니다.
 >   우선순위 순서대로 이동했으며, 미세 조정은 ZenHub 보드에서 드래그로 조정하세요.

.claude/docs/{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/
    ├── project.md            # Project 상세 정보 (--project 사용 시)
    ├── epic.md               # Epic 상세 정보
    ├── priority.md           # 우선순위 검토 결과 + 파이프라인 배치 기록
    └── stories/
        ├── list_story.md     # 목록 Story 정보
        ├── detail_story.md   # 상세 Story 정보
        └── form_story.md     # 폼 Story 정보

# {Project/Milestone Name}

## 📄 상세 기획
**{artifact_url}**

↳ {아티팩트에 담긴 섹션 목록}

{공유 안내 문구 — Issue Body Artifact Contract 고정 문구}

## 📋 개요
{Project/Initiative에 대한 간략한 설명}

## 💼 비즈니스 가치
{이 Project/Initiative가 해결하는 문제와 기대 효과}

## 📊 범위

### 포함
- ✅ {epic_1} — {한 줄 설명}
- ✅ {epic_2} — {한 줄 설명}

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

## 🔢 우선순위
| 순위 | Epic | 티어 | impact | 근거 |
|------|------|------|--------|------|
| 1 | {epic_1} | P0 | high | {근거} |

## 📎 관련 이슈
- 상위: #{parent_number} ({Initiative})       ← Project가 Initiative 하위일 때만
- [ ] #{epic_1_number} - {epic_1}
- [ ] #{epic_2_number} - {epic_2}

---
 >   🤖 Generated by `/cc-dev:zenhub:breakdown`

# {Feature} 기능 구현

## 📄 상세 기획
**{artifact_url}**

↳ {아티팩트에 담긴 섹션 목록}

{공유 안내 문구 — Issue Body Artifact Contract 고정 문구}

## 📋 개요
{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}/.claude/docs/{feature}/screenshots/list.png)

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

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

 >   또는 Figma 링크: {figma_urls}

## 🔢 우선순위
| 순위 | 이슈 | 티어 | impact | 근거 |
|------|------|------|--------|------|
| 1 | {feature} 목록 화면 | P0 | high | {근거} |

## 📎 관련 이슈
- 상위: #{project_number} ({Project})       ← Project/Initiative 하위일 때만
- [ ] #{item_1_number} - 목록 화면
- [ ] #{item_2_number} - 상세 화면
- [ ] #{item_3_number} - 폼 화면

## 📐 예상 Story Point
{total_points} (하위 항목 롤업)

---
 >   🤖 Generated by `/cc-dev:zenhub:breakdown`

# {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}/.claude/docs/{feature}/screenshots/{screen}.png)

 >   또는 Figma 링크: {figma_link}

## 📎 관련 이슈
- 상위: #{epic_number} (Epic)       ← scale=no-epic이면 생략 또는 Project/Initiative로 대체

## 📐 예상 Story Point
{point_value}

---
 >   🤖 Generated by `/cc-dev:zenhub:breakdown`

# {defect_summary}

## 📋 개요
{what_is_broken}

## 🔁 재현 절차
1. {step_1}
2. {step_2}
3. {step_3}

## 🎯 기대 결과 vs 실제 결과
- **기대**: {expected}
- **실제**: {actual}

## ⚠️ 심각도
{Critical/High/Medium/Low} — {rationale}

## 📎 관련 이슈
- 상위: #{epic_number} (Epic)       ← scale=no-epic이면 생략

## 📐 예상 Story Point
{point_value}

---
 >   🤖 Generated by `/cc-dev:zenhub:breakdown`

# {work_summary}

## 📋 개요
{what_needs_to_be_done}

## ☑️ 완료 정의 (Definition of Done)
- [ ] {criterion_1}
- [ ] {criterion_2}
- [ ] {criterion_3}

## 🛠️ 기술 작업
- [ ] {implementation_step_1}
- [ ] {implementation_step_2}

## 📎 관련 이슈
- 상위: #{epic_number} (Epic)       ← scale=no-epic이면 생략

## 📐 예상 Story Point
{point_value}

---
 >   🤖 Generated by `/cc-dev:zenhub:breakdown`

/cc-dev:zenhub:breakdown community Post

# Auto-inferred: a single small bug needs no Epic
/cc-dev:zenhub:breakdown  " 로그인 버튼 텍스트 오타 수정 " 

 # Force-skip Epic explicitly
/cc-dev:zenhub:breakdown community Post --no-epic

# Create new Project + Epics under it
/cc-dev:zenhub:breakdown community Post --project  " 어드민 콘솔 v2 " 

 # Multiple Epics under one Project (2+ --epics entries auto-infers Project scale)
/cc-dev:zenhub:breakdown --project  " 어드민 콘솔 v2 "   --epics  " auth,community,payment " 

 # Link Epic to an existing Project issue
/cc-dev:zenhub:breakdown community Post --parent-project 1024

/cc-dev:zenhub:breakdown community Post \
  --requirements .claude/docs/community/requirements.md \
  --bdd-dir .claude/docs/community/bdd/

/cc-dev:zenhub:breakdown community Post \
  --labels  " sprint-1,mvp "   \
  --sprint current

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

/cc-dev:zenhub:breakdown community Post \
  --images  " list.png,detail.png,form.png "

/cc-dev:zenhub:breakdown community Post \
  --images-dir ./screenshots/community/

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

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

1. issueMap 정리 — 생성 시점에 확보한 이슈 번호를 구조로 보고 (출력 로그 재파싱 금지):
   { initiative?: #, project?: #, epics: [{number, title, priority, children: [#…]}], standalone: [#…] }
2. /cc-dev:go 컨텍스트 — /cc-dev:go Phase B 에서 호출된 경우: issueMap 반환 후 즉시 종료.
   후속 질문 금지 — 실행 여부는 /cc-dev:go Phase C(통합 계획 게이트)가 담당한다.
3. 단독 실행 컨텍스트 — 사람이 /cc-dev:zenhub:breakdown 을 직접 부른 경우, AskUserQuestion 1회:
   - [바로 개발 시작] → Epic 이 있으면 P0 Epic 부터 /cc-dev:batch {epic}, Epic 없이 standalone 뿐이면 /cc-dev:run {issue}
   - [이슈만 생성하고 종료] → 재개 명령을 안내하고 종료:
      " 이어서: /cc-dev:batch {epic} · /cc-dev:run {issue} · 처음부터 원스톱은 /cc-dev:go "