cd ~/dev/tools/WebDriverAgent
xcodebuild -project WebDriverAgent.xcodeproj \
  -scheme WebDriverAgentRunner \
  -destination 'platform=iOS Simulator,name={시뮬레이터 이름}' \
  test

Read(".claude/guide/mobile/flutter_best_practices.md")
Read(".claude/guide/mobile/getx_best_practices.md")

Read("docs/[product]/[feature]/user-story.md")          # 사용자 스토리 - 테스트 시나리오 기반
Read("docs/[product]/[feature]/mobile-design-spec.md")  # UI/UX 명세 - UI 검증 기준
Read("docs/[product]/[feature]/mobile-brief.md")        # 기술 아키텍처 - 테스트 범위 파악

Glob("docs/**/test-scenarios.md")  # 과거 테스트 시나리오 문서

resolve-library-id(libraryName="flutter", query="Flutter testing best practices")
query-docs(libraryId="...", query="widget testing patterns")
query-docs(libraryId="...", query="integration testing")

search(query="Flutter 테스트 시나리오", limit=5)
search(query="UI 테스트 자동화", limit=3)
get_recent_context(limit=10)  # 최근 컨텍스트에서 테스트 패턴 확인

## 테스트 시나리오: [기능명]

### Scenario 1: [시나리오명] (Happy Path)
**Given**: [초기 상태 - 어떤 화면, 어떤 데이터, 어떤 상태]
**When**: [사용자 액션 - 버튼 클릭, 텍스트 입력, 스크롤 등]
**Then**: [예상 결과 - UI 변화, 상태 변화, API 호출, 네비게이션]

**수동 테스트 절차**:
1. [명확한 단계별 절차]
2. [스크린샷 확인 포인트]
3. [로그 확인 포인트]
4. [검증 기준]

**자동화 테스트 및 UI 검증 (@mobilenext/mobile-mcp)**:
\```bash
# MCP 서버(.mcp.json)에 등록됨 — Claude가 직접 도구로 호출

# 자동화 테스트 (UI 인터랙션)
- mobile_click_on_screen_at_coordinates: "[버튼명]" 위치 탭
- mobile_type_keys: "[위젯명]에 '[텍스트]' 입력"
- mobile_swipe_on_screen: "화면 스크롤"
- mobile_take_screenshot: "현재 화면 스크린샷 캡처"

# UI 검증 (접근성 트리 기반)
- mobile_list_elements_on_screen: 접근성 트리에서 '[텍스트]' 요소 확인
- mobile_take_screenshot: 주요 화면 스크린샷 캡처 (before/after)
- mobile-design-spec.md와 색상, 타이포그래피 비교
- 터치 영역 크기 확인 (최소 44x44pt)
\```

**검증 체크리스트**:
- [ ] UI가 mobile-design-spec.md와 일치하는가?
- [ ] 로딩 상태가 표시되는가?
- [ ] 에러 상태가 사용자에게 명확히 전달되는가?
- [ ] 접근성 레이블이 적절한가?
- [ ] Hot reload 후에도 정상 동작하는가?

mobile_take_screenshot        # 현재 화면 스크린샷 캡처
mobile_save_screenshot        # 스크린샷 파일 저장
mobile_list_elements_on_screen # 접근성 트리 기반 화면 요소 목록
mobile_click_on_screen_at_coordinates  # 좌표 기반 탭
mobile_double_tap_on_screen   # 더블 탭
mobile_long_press_on_screen_at_coordinates  # 길게 누르기
mobile_swipe_on_screen        # 스와이프 (스크롤)
mobile_type_keys              # 텍스트 입력
mobile_press_button           # 하드웨어 버튼 (홈, 뒤로가기)
mobile_uninstall_app          # 앱 삭제

# 자동화 테스트 (UI 인터랙션)
- mobile_list_elements_on_screen으로 화면 요소 확인
- mobile_click_on_screen_at_coordinates로 "[버튼명]" 탭
- mobile_type_keys로 "[필드명]에 '[텍스트]' 입력"
- mobile_swipe_on_screen으로 "화면 스크롤"
- mobile_press_button으로 "뒤로가기"
- mobile_take_screenshot으로 "결과 화면 캡처"

# UI 검증 (접근성 트리 기반)
- mobile_list_elements_on_screen으로 '[텍스트]' 요소 확인
- mobile_take_screenshot으로 before/after 스크린샷 캡처
- mobile-design-spec.md와 색상, 타이포그래피 비교
- 터치 영역 크기 확인 (최소 44x44pt)

### Scenario 3: 빈 입력 처리 (Edge Case)
**Given**: 날씨 검색 화면이 열려 있다
**When**: 도시 이름을 입력하지 않고 검색 버튼을 탭한다
**Then**: "도시 이름을 입력해주세요" 에러 메시지가 표시된다

### Scenario 4: 네트워크 에러 처리 (Error Case)
**Given**: 날씨 검색 화면이 열려 있고, 네트워크가 끊긴 상태이다
**When**: 도시 이름을 입력하고 검색 버튼을 탭한다
**Then**: "네트워크 연결을 확인해주세요" 에러 메시지가 표시된다

# [기능명] 테스트 시나리오

> 생성일: [날짜]
> 대상 기능: [기능 설명]
> 참조 문서: mobile-brief.md, mobile-design-spec.md, user-story.md

## 개요

[기능에 대한 간단한 설명]

## 테스트 환경

- **플랫폼**: iOS, Android
- **Flutter 버전**: [버전]
- **테스트 도구**:
  - @mobilenext/mobile-mcp (자동화 + UI 검증): `.mcp.json`에 등록된 MCP 서버

## 사전 조건

- [ ] 앱이 빌드되고 실행 가능한 상태
- [ ] 에뮬레이터/시뮬레이터가 실행 중
- [ ] WebDriverAgent가 실행 중 (iOS 시뮬레이터인 경우)
- [ ] API 서버가 정상 동작 중 (필요 시)

---

## 테스트 시나리오: [기능명]

### Scenario 1: [시나리오명] (Happy Path)
[위의 템플릿 형식으로 작성]

### Scenario 2: [시나리오명] (Alternative Path)
[위의 템플릿 형식으로 작성]

### Scenario 3: [시나리오명] (Edge Case)
[위의 템플릿 형식으로 작성]

### Scenario 4: [시나리오명] (Error Case)
[위의 템플릿 형식으로 작성]

---

## 통합 테스트 시나리오

[여러 기능을 연결한 엔드투엔드 시나리오]

---

## 접근성 테스트

- [ ] 모든 인터랙티브 요소에 접근성 레이블 있음
- [ ] 터치 영역이 최소 44x44pt
- [ ] 색 대비가 WCAG AA 기준 충족 (텍스트 4.5:1, UI 요소 3:1)
- [ ] 스크린 리더로 화면 읽기 가능
- [ ] 키보드 네비게이션 지원 (필요 시)

---

## 성능 테스트

- [ ] 초기 로딩 시간 3초 이내
- [ ] 화면 전환 애니메이션 60fps 유지
- [ ] Hot reload 정상 동작
- [ ] 메모리 누수 없음

---

## 실행 요약

### 수동 테스트
1. 각 시나리오의 "수동 테스트 절차" 섹션 따라가기
2. 검증 체크리스트 항목 확인
3. 스크린샷 캡처 (before/after)
4. 발견된 이슈 기록

### 자동화 테스트 및 UI 검증 (@mobilenext/mobile-mcp)

---

## 참고 사항

- 모든 테스트는 clean state에서 시작
- 각 테스트 간 독립성 유지
- 실패 시 로그 및 스크린샷 캡처
- 재현 가능한 버그 리포트 작성

Read(".claude/skills/test-scenario-generator/templates/scenario-template.md")

# Flutter 테스트 베스트 프랙티스
resolve-library-id(libraryName="flutter", query="Flutter testing")
query-docs(libraryId="...", query="widget testing patterns")
query-docs(libraryId="...", query="integration testing best practices")
query-docs(libraryId="...", query="accessibility testing")

# 과거 테스트 시나리오 패턴 참조
search(query="Flutter 테스트 시나리오 작성", limit=5)
search(query="UI 테스트 자동화", limit=3)
search(query="Given-When-Then 패턴", limit=3)

# 최근 컨텍스트
get_recent_context(limit=10)