/figma:analyze {figma_urls...} [--options]

입력된 피그마 URL들을 파싱하고 검증합니다.

지원 URL 형식:
- https://www.figma.com/file/{key}/{name}?node-id={id}
- https://www.figma.com/design/{key}/{name}?node-id={id}

// 각 프레임 캡처
for (const url of figmaUrls) {
  await browser_navigate({ url });
  await browser_snapshot();  // 접근성 트리 캡처
  await browser_take_screenshot({ filename: `frame_${index}.png` });
}

피그마에 직접 접근할 수 없습니다.
다음 in progress 하나를 선택해 주세요:

1. 스크린샷 파일 경로 제공
2. 화면 설명 직접 입력
3. 피그마 내보내기 이미지 첨부

screen_analysis:
  screen_type: list | detail | form | other

  components:
    - type: AppBar
      elements: [title, search_button, menu]
    - type: ListView
      item_component: Card
      pagination: infinite_scroll
    - type: FAB
      action: navigate_to_create

  data_fields:
    - field: title
      display: text
      editable: true
    - field: thumbnail
      display: image
      editable: true

  user_actions:
    - tap_card: navigate_to_detail
    - tap_fab: navigate_to_create
    - pull_refresh: reload_list

# {Feature} 요구사항 명세

## Entity 정의

### {Entity}
| 필드 | 타입 | 필수 | 설명 |
|------|------|------|------|
| id | int | ✅ | 고유 식별자 |
| title | String | ✅ | Title |
| content | String | ✅ | Content |
| category | {Entity}Category | ✅ | Category |
| imageUrls | List < String > ? | ❌ | 이미지 URL 목록 |
| authorId | int | ✅ | 작성자 ID |
| createdAt | DateTime | ✅ | 생성일시 |

### {Entity}Category (Enum)
- general: 일반
- notice: 공지
- event: 이벤트

## 화면 정의

### 1. 목록 화면
- 경로: /{feature}
- 기능: Pagination, 필터, 검색, 정렬
- 컴포넌트: AppBar, FilterBar, ListView, FAB

### 2. 상세 화면
- 경로: /{feature}/{id}
- 기능: 상세 보기, 좋아요, 수정/삭제
- 컴포넌트: SliverAppBar, ContentSection, ActionBar

### 3. 폼 화면
- 경로: /{feature}/create, /{feature}/{id}/edit
- 기능: 생성/수정 폼, 이미지 업로드
- 컴포넌트: Form, ImagePicker, SubmitButton

## API 정의

| 메서드 | 설명 |
|--------|------|
| get{Entity}s | 목록 조회 (Pagination) |
| get{Entity} | 단건 조회 |
| create{Entity} | 생성 |
| update{Entity} | 수정 |
| delete{Entity} | 삭제 |

Feature: {feature} List # {feature} 목록
  As a user, I want to view the {feature} list. # 사용자로서 {feature} 목록을 보고 싶습니다

  Background:
    Given the app is running # 앱이 실행 중입니다
    And user is logged in # 로그인되어 있습니다

  @smoke
  Scenario: List loads successfully # 목록 로딩 성공
    When I navigate to the {feature} page # {feature} 페이지로 이동합니다
    Then the {feature} list is displayed # {feature} 목록이 보입니다
    And at least 1 {entity} card is displayed # 최소 1개의 {entity} 카드가 보입니다

  @refresh
  Scenario: Pull to refresh # 당겨서 새로고침
    Given I am on the {feature} list page # {feature} 목록 페이지에 있습니다
    When I pull down to refresh # 아래로 당겨서 새로고침합니다
    Then the list is refreshed # 목록이 갱신됩니다

  @navigation
  Scenario: Tap card to navigate to detail # 카드 탭하여 상세 이동
    Given I am on the {feature} list page # {feature} 목록 페이지에 있습니다
    When I tap the first {entity} card # 첫 번째 {entity} 카드를 탭합니다
    Then I navigate to the {entity} detail page # {entity} 상세 페이지로 이동합니다

claudedocs/{feature_name}/bdd/
├── scenarios.md              # BDD 시나리오 요약
├── {feature}_list.feature    # 목록 화면 시나리오
├── {feature}_detail.feature  # 상세 화면 시나리오
└── {feature}_form.feature    # 폼 화면 시나리오

## Epic 생성

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

**내용**:
- 비즈니스 가치 설명
- 범위 정의 (포함/제외)
- 기술 노트
- Figma  reference 링크

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

## Story 목록

| Screen | Title | Point | Acceptance Criteria Count |
|------|------|-------|-------|
| 목록 | {feature} 목록 화면 | 3 | 8 |
| 상세 | {feature} 상세 화면 | 3 | 9 |
| 폼 | {feature} 폼 화면 | 5 | 10 |

## 인수 기준 (Acceptance Criteria)

### AC1: 목록 로딩 성공

- **Priority**: High
- **Tag**: @smoke

claudedocs/{feature_name}/zenhub/
├── epic.md                   # Epic 정보
└── stories/
    ├── list_story.md         # 목록 화면 Story
    ├── detail_story.md       # 상세 화면 Story
    └── form_story.md         # 폼 화면 Story

## 📋 분석 결과 확인

### Entity Fields
| 필드 | 타입 | 필수 |
|------|------|------|
| title | String | ✅ |
| content | String | ✅ |
| category | {Entity}Category | ✅ |
| imageUrls | List < String > ? | ❌ |

### 식별된 화면
- 목록 화면 (8개 BDD 시나리오)
- 상세 화면 (9개 BDD 시나리오)
- 폼 화면 (10개 BDD 시나리오)

### ZenHub Issues
- Epic: {feature} 기능 구현
- Stories: 3개 (총 11 Point)

### 추천 설정
- 캐싱: SWR
- 엔드포인트: App only

---

**다음 작업을 선택해 주세요:**

1. ✅ Feature 코드 생성 진행
2. ✏️ 요구사항 수정
3. 📝 BDD 시나리오 수정
4. 🎫 ZenHub 이슈만 생성
5. ❌ 취소

/feature:create {feature_name} {entity_name}
  --location application
  --caching swr
  --fields  " title:String, content:String, category:{Entity}Category, imageUrls:List < String > ? " 
   --with-bdd true

# claudedocs에서 feature 테스트 디렉토리로 복사
cp claudedocs/{feature}/bdd/*.feature feature/application/{feature}/test/src/bdd/

# Step 정의 생성
/bdd:generate {feature_name}

# Generate BDD test code
melos run test:bdd:generate --scope={feature_name}

claudedocs/{feature_name}/
├── figma_analysis.md          # Figma analysis result
├── requirements.md            # 요구사항 명세
├── screenshots/               # Captured screenshots
│   ├── 01_list.png
│   ├── 02_detail.png
│   └── 03_form.png
├── bdd/                       # BDD 시나리오 (신규)
│   ├── scenarios.md
│   ├── {feature}_list.feature
│   ├── {feature}_detail.feature
│   └── {feature}_form.feature
├── zenhub/                    # ZenHub 이슈 (신규)
│   ├── epic.md
│   └── stories/
│       ├── list_story.md
│       ├── detail_story.md
│       └── form_story.md
└── field_mapping.yaml         # 필드 매핑 정보

feature/application/{feature_name}/test/src/bdd/  # BDD 테스트 (신규)
├── {feature}_list.feature
├── {feature}_detail.feature
├── {feature}_form.feature
├── step/
│   └── {feature}_steps.dart
└── hooks/
    └── hooks.dart

/figma:analyze
   " https://www.figma.com/file/abc/App?node-id=1:100 " 
   " https://www.figma.com/file/abc/App?node-id=1:200 " 
   " https://www.figma.com/file/abc/App?node-id=1:300 "

/figma:analyze
   " https://www.figma.com/file/abc/App?node-id=1:100 " 
   --feature-name community
  --entity-name Post
  --zenhub-labels  " sprint-1,mvp "

/figma:analyze
   " https://www.figma.com/file/abc/App?node-id=1:100 " 
   --feature-name community
  --create-zenhub false
  --generate-bdd true

/figma:analyze
   " https://www.figma.com/file/abc/App?node-id=1:100 " 
   --feature-name community
  --skip-feature true

/figma:analyze
  /path/to/list_screen.png
  /path/to/detail_screen.png
  /path/to/form_screen.png
  --feature-name community

indicators:
  - 여러 개의 반복되는 카드/아이템
  - 스크롤 가능한 레이아웃
  - 필터/검색 바
  - FAB (추가 버튼)

extract:
  - 카드 내 필드 (제목, 썸네일, 날짜 등)
  - 필터 옵션 (카테고리, 정렬)
  - Pagination 타입

bdd_scenarios:
  - 목록 로딩 성공
  - 당겨서 새로고침
  - 무한 스크롤
  - 카드 탭 → 상세 이동
  - FAB 탭 → 생성 페이지 이동
  - 필터 적용
  - 빈 목록
  - 로딩 실패

indicators:
  - 단일 아이템의 전체 정보
  - 큰 이미지/갤러리
  - 액션 버튼 (좋아요, 공유, 수정)
  - 관련 컨텐츠 섹션

extract:
  - 모든 표시 필드
  - 사용자 액션
  - 네비게이션 관계

bdd_scenarios:
  - 상세 정보 표시
  - 좋아요 토글
  - 수정 페이지 이동
  - 삭제 확인
  - 공유하기
  - 뒤로 가기
  - 로딩 실패

indicators:
  - 입력 필드 (TextField, Dropdown 등)
  - 저장/취소 버튼
  - 유효성 검사 메시지

extract:
  - 입력 필드 타입
  - 필수/선택 여부
  - 유효성 규칙

bdd_scenarios:
  - 유효한 폼 제출
  - 필수 필드 누락
  - 글자 수 제한
  - 이미지 첨부/삭제
  - 작성 취소
  - 저장 실패