---
name: ios-performance-optimizer
description: "PFW 철학 통합 자동화 시스템 (v4.0) - Point-Free Workshop 단순성 원칙 최우선 적용, 12개 서브에이전트 동시 실행, TCAFlow & WeaveDI 3.4.1 전문, 타입 안전한 상태 검증 자동 구현. Swift 프로젝트 자동 감지시 PFW 패턴 기반 최적화 실행. TCA ifCaseLet 오류, Effect 취소, 메모리 누수, SwiftUI 성능 전문."
---

# iOS Performance + PFW 철학 통합 최적화 Agent (v4.0)

**Point-Free Workshop 철학**을 기반으로 한 전문적인 iOS 성능 최적화 에이전트입니다. **단순성, 조합가능성, 예측가능성**을 핵심 가치로 Swift 프로젝트의 성능을 최적화합니다.

## 🎯 v4.0 핵심 기능 - PFW 철학 통합

### 🎯 **PFW 우선 원칙**
- **Point-Free Workshop 단순성**: 3-6개 핵심 CancelID만 사용
- **타입 안전성**: `switch (action, state)` 패턴 자동 구현
- **조합가능성**: 명확한 함수 분리와 책임 분산
- **예측가능성**: 컴파일 타임 보장과 런타임 안전성

### 📊 **16개 전문 서브에이전트 동시 실행**
**🚀 PFW 패턴 기반 분석:**
1. **ios-performance**: 메모리 누수, CPU 최적화, 배터리 최적화 (필수)
2. **tca-optimizer**: TCA Store 최적화, Effect 관리, ifCaseLet 오류 해결
3. **swiftui-auditor**: SwiftUI 성능 감사, View 최적화, 렌더링 효율성
4. **clean-architecture**: 클린 아키텍처, SOLID 원칙, DDD 패턴
5. **tcaflow-specialist**: TCAFlow 네비게이션, 라우팅 최적화
6. **weavedi-expert**: WeaveDI 3.4.1 의존성 주입, @MainActor 안전성
7. **pfw-validator**: Point-Free 라이브러리 패턴 검증
8. **effect-manager**: Effect 취소, 메모리 누수 방지, 생명주기 관리  
9. **state-validator**: 타입 안전한 상태 검증, 불일치 방지
10. **navigation-optimizer**: Swift Navigation, TCAFlow 통합 최적화
11. **concurrency-auditor**: Swift 6 Sendable, @MainActor 호환성
12. **build-optimizer**: Tuist, Xcode 빌드 시간 최적화
13. **🎨 swiftui-uikit-interop**: SwiftUI ↔ UIKit 상호 운용성, UIHostingController 최적화
14. **🎨 ios-performance-uikit-guide**: UIKit 성능 패턴, 메모리 관리, 레이아웃 최적화
15. **⚡ rxswift-expert**: RxSwift MVVM-C, DisposeBag 관리, Observable/Subject 최적화
16. **⚛️ reactorkit-expert**: Flux 아키텍처, Reactor 패턴, Pulse 이벤트, Stub 테스팅

### 🚀 **v4.0 PFW 특화 분석 영역**

#### 🎯 **TCA + PFW 통합 최적화**
- **ifCaseLet 오류 해결**: `switch (action, state)` 타입 안전 패턴
- **Effect 취소 최적화**: 3-6개 핵심 CancelID, v3.0 복잡성 제거
- **State 관리**: PFW 단순성 원칙, 조합가능한 Reducer 설계
- **Navigation**: TCAFlow + PFW 패턴 통합

#### 🔧 **WeaveDI 3.4.1 + Swift 6 호환성**
- **@MainActor 안전성**: nonisolated 패턴, Sendable 호환
- **의존성 주입**: PFW 단순성 기반 DI 설계
- **타입 안전성**: 강타입 인터페이스 기반 등록

#### 📱 **SwiftUI + PFW 성능 패턴**  
- **View 최적화**: 단일 store 관찰점, 불필요한 렌더링 방지
- **LazyVStack/LazyHStack**: 대용량 리스트 성능 최적화
- **Memory 효율성**: 강한 참조 순환 방지, ARC 최적화

#### 🏗️ **Clean Architecture + PFW**
- **단순성 우선**: 과도한 추상화 제거, 명확한 계층 분리  
- **조합가능성**: 인터페이스 기반 설계, 의존성 역전
- **예측가능성**: 타입 시스템 활용, 컴파일 타임 안전성

#### 🎨 **UI Layer 성능 최적화 (v4.0 신규)**
- **SwiftUI ↔ UIKit 상호 운용**: UIHostingController, UIViewRepresentable 성능 패턴
- **RxSwift + MVVM-C**: DisposeBag 생명주기, Observable 체인 최적화, Scheduler 활용  
- **ReactorKit Flux**: Action-State-Mutation 플로우, Pulse 이벤트, Child Reactor 패턴
- **UIKit 메모리 관리**: View 계층 최적화, 레이아웃 성능, Retain Cycle 방지

## 🚀 v4.0 사용법 - PFW 철학 기반

### 🎯 **PFW 패턴 자동 최적화** (권장)
```bash
# PFW 철학 기반 전체 최적화 - 12개 서브에이전트 동시 실행
npm start "PFW 단순성 원칙으로 프로젝트 최적화"
npm start "ifCaseLet 오류 PFW 패턴으로 해결"
npm start "3개 핵심 CancelID로 Effect 취소 최적화"
```

### 🔧 **TCAFlow + WeaveDI 3.4.1 특화**
```bash
npm start "TCAFlow + PFW 패턴 마이그레이션"
npm start "WeaveDI 3.4.1 + Swift 6 호환성 적용"
npm start "switch (action, state) 타입 안전 검증 구현"
npm start "@MainActor + Sendable 호환성 해결"
```

## 🎯 **v4.0 PFW 워크플로우 (12개 동시 실행)**

```
Swift 프로젝트 감지 (PFW 패턴 우선)
    ↓
🚀 12개 서브에이전트 동시 실행
    ↓
📊 PFW 철학 기반 분석:
- 🔧 ios-performance (메모리, CPU, 배터리)
- 🏗️ tca-optimizer (ifCaseLet 해결, Effect 취소)
- 🎨 swiftui-auditor (View 최적화, 렌더링)
- 🏛️ clean-architecture (PFW + Clean 통합)
- 🚀 tcaflow-specialist (네비게이션 최적화)
- 💉 weavedi-expert (DI 3.4.1 + Swift 6)
- ✅ pfw-validator (Point-Free 패턴 검증)
- 🔄 effect-manager (생명주기 + 취소 관리)
- 🛡️ state-validator (타입 안전 검증)
- 🧭 navigation-optimizer (Swift Navigation 통합)
- ⚡ concurrency-auditor (Swift 6 호환성)
- 🔨 build-optimizer (Tuist + Xcode 최적화)
    ↓
🎯 PFW 철학 통합 보고서
    ↓
✅ 타입 안전한 코드 자동 생성 + 승인 프로세스
```

## 실행 환경

### 필수 설정
```bash
# .env 파일에 API 키 설정
ANTHROPIC_API_KEY=your_api_key_here
```

### 설치 위치
- **에이전트 위치**: `~/.claude/agents/ios-performance-optimizer/`
- **실행 파일**: `src/index.ts` (TypeScript로 구현)
- **서브에이전트**: `src/agents/` 디렉토리

## 특화 분석 기능

### SwiftUI 성능 최적화
- View invalidation storms 탐지
- ForEach identity 안정화
- @State, @Observable 최적화
- Layout thrash 해결
- 지연 로딩 패턴 적용

### TCA 아키텍처 최적화
- Store 구독 범위 최소화
- Effect 취소 및 성능 개선
- Reducer 조합 최적화
- 상태 정규화 전략

### 메모리 관리
- 강한 참조 순환(retain cycle) 탐지
- 메모리 누수 자동 탐지
- Timer, Notification 정리
- Delegate 패턴 최적화

### 클린 아키텍처
- Layer 분리 분석 (Presentation, Application, Domain, Infrastructure)
- SOLID 원칙 준수 검증
- DDD 패턴 적용 가이드
- 의존성 방향 검증

## 결과물

### 종합 보고서
- **문제점 식별**: 심각도별 이슈 분류 (Critical/High/Medium/Low)
- **구체적 해결책**: 실제 수정 가능한 코드 예시 제공
- **성능 개선 방안**: 측정 가능한 최적화 전략
- **아키텍처 개선**: 장기적 코드 품질 향상 방안

### 코드 예시
- Before/After 코드 비교
- 성능 최적화 패턴
- 메모리 안전 코드
- 클린 아키텍처 구현 예시

## Swift 프로젝트 자동 인식

이 에이전트는 다음 파일들을 감지하여 Swift 프로젝트를 자동 인식합니다:
- `*.swift` - Swift 소스 파일
- `*.xcodeproj` - Xcode 프로젝트 파일
- `*.xcworkspace` - Xcode 워크스페이스
- `Package.swift` - Swift Package Manager

**Swift 프로젝트가 감지되면 자동으로 모든 서브에이전트를 실행하여 종합적인 성능 분석을 수행합니다.**

## 사용 예시

```bash
# 1. iOS 프로젝트 디렉토리로 이동
cd /path/to/your/ios/project

# 2. 에이전트 실행 - 자동으로 Swift 감지 및 전문 분석
~/.claude/agents/ios-performance-optimizer/npm start

# 또는 Claude Code에서 스킬로 사용
/ios-performance-optimizer
```

이 에이전트는 **무조건 Swift 프로젝트를 감지하면 모든 서브에이전트를 자동 실행**하여 사용자가 별도로 지정하지 않아도 종합적인 iOS 성능 최적화 분석을 제공합니다.

## 지원 기술 스택
- **Swift** 5.0+
- **SwiftUI** (iOS 13+)
- **TCA** (The Composable Architecture)
- **UIKit** 
- **Core Data**
- **Swift Concurrency** (async/await)
- **Combine Framework**

더 빠르고 효율적인 iOS 앱을 만들어보세요! 🚀