agent-skill-kit 3.9.135

package/.agent/skills/mobile-developer/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: mobile-developer
+description: >-
+  Mobile development with React Native, Flutter, or native iOS/Android.
+  Use when building mobile apps, configuring native modules, or optimizing mobile performance.
+  NOT for web frontend (use react-pro) or mobile design decisions (use mobile-design).
+category: mobile-architect
+triggers: ["React Native", "Flutter", "iOS", "Android", "mobile app", "cross-platform", "native app"]
+coordinates_with: ["mobile-first", "mobile-design", "test-architect", "perf-optimizer", "mobile-security-coder", "code-craft", "problem-checker"]
+success_metrics: ["100% Build Pass", "0 IDE/Lint Errors", "OWASP MASVS Compliant"]
+metadata:
+  author: pikakit
+  version: "3.9.134"
+---
+
+# Mobile Developer — Cross-Platform & Native Expert
+
+> 4 frameworks. 4 architectures. 4 test levels. 6 security items. 60fps target.
+
+---
+
+## 5 Must-Ask Questions (Before Any Development)
+
+| # | Question | Options |
+|---|----------|---------|
+| 1 | Platform? | iOS, Android, or both |
+| 2 | Framework? | React Native, Flutter, native |
+| 3 | Navigation? | Tabs, stack, drawer |
+| 4 | Offline? | Must work offline? |
+| 5 | Devices? | Phone only or tablet too |
+
+---
+
+## When to Use
+
+| Situation | Action |
+|-----------|--------|
+| Choose mobile framework | Framework selection tree |
+| Design app architecture | Architecture routing |
+| Plan testing strategy | 4-level test plan |
+| Security compliance | OWASP MASVS checklist |
+| Store submission | ASO checklist |
+
+---
+
+## System Boundaries
+
+| Owned by This Skill | NOT Owned |
+|---------------------|-----------|
+| Framework selection (4 options) | Mobile design (→ mobile-design) |
+| Architecture routing (4 patterns) | Mobile orchestration (→ mobile-first) |
+| Testing strategy (4 levels) | Security code review (→ mobile-security-coder) |
+| Security checklist (6 items) | Performance profiling (→ perf-optimizer) |
+
+**Expert decision skill:** Produces recommendations and checklists. Does not write code.
+
+---
+
+## Framework Selection (Deterministic)
+
+| Need | Framework |
+|------|-----------|
+| OTA updates, rapid iteration | **React Native + Expo** |
+| Pixel-perfect custom UI | **Flutter** |
+| Deep iOS platform features | **SwiftUI** |
+| Deep Android platform features | **Kotlin + Compose** |
+| Cross-platform, no special needs | **React Native + Expo** (default) |
+
+---
+
+## Architecture Routing (Deterministic)
+
+| Context | Pattern |
+|---------|---------|
+| Complex app + large team (6+) | **Clean Architecture** |
+| UI-driven app, moderate complexity | **MVVM** |
+| Complex state management | **BLoC / Redux** |
+| Data abstraction needed | **Repository** |
+
+---
+
+## Performance Targets (Fixed)
+
+| Target | Value |
+|--------|-------|
+| Animation framerate | 60fps |
+| App startup (cold) | < 2,000 ms |
+| List rendering | Virtualized (FlatList / ListView) |
+| Memory leaks | Zero (enforce cleanup) |
+
+---
+
+## Platform Services
+
+| Service | Technologies |
+|---------|-------------|
+| Push | FCM, APNs |
+| Auth | OAuth, Biometric, Social |
+| Payments | Stripe, Apple Pay, Google Pay |
+| Maps | Google Maps, Apple MapKit |
+| Analytics | Firebase, Sentry |
+
+---
+
+## Testing Strategy (4 Levels)
+
+| Level | Tools |
+|-------|-------|
+| Unit | Jest, Dart test, XCTest |
+| Component | React Native Testing Library |
+| E2E | Detox, Maestro, Patrol |
+| Device | Firebase Test Lab, Bitrise |
+
+---
+
+## Security Checklist (OWASP MASVS — 6 Items)
+
+- [ ] OWASP MASVS compliance
+- [ ] Certificate pinning
+- [ ] Biometric authentication
+- [ ] Secure storage (Keychain/Keystore)
+- [ ] Code obfuscation (ProGuard/R8)
+- [ ] GDPR/privacy compliance
+
+---
+
+## Audit Logging (OpenTelemetry)
+
+| Event | Metadata Payload | Severity |
+|-------|------------------|----------|
+| `build_verification` | `{"framework": "...", "platform": "...", "status": "pass/fail"}` | `INFO` |
+| `architecture_decision` | `{"state_management": "...", "storage": "..."}` | `INFO` |
+| `security_audit` | `{"masvs_compliant": true, "token_storage": "SecureStore"}` | `INFO` |
+
+All executions MUST emit the `build_verification` span before reporting completion.
+
+---
+
+## Error Taxonomy
+
+| Code | Recoverable | Trigger |
+|------|-------------|---------|
+| `ERR_INVALID_REQUEST_TYPE` | No | Request type not supported |
+| `ERR_UNKNOWN_PLATFORM` | Yes | Platform not ios/android/both |
+| `ERR_MISSING_PLATFORM` | Yes | Platform not provided |
+| `WARN_CONFLICT` | Yes | Conflicting requirements |
+
+**Zero internal retries.** Deterministic; same context = same recommendation.
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|---------|-------|
+| Pick framework without criteria | Use framework selection tree |
+| Skip architecture for "simple" apps | At minimum use Repository pattern |
+| Assume network availability | Design offline-first |
+| Skip security for MVP | OWASP MASVS from day 1 |
+| Test only on simulator | Include real device testing |
+| Ignore IDE errors without fixing | Call `problem-checker` to auto-fix |
+
+---
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| iOS build fails | `pod install --repo-update` |
+| Android Gradle error | Check Gradle version, sync project |
+| Hot reload broken | Restart Metro/Flutter, clear cache |
+| Native module linking | `npx react-native link` or `flutter pub get` |
+| App store rejection | Check guidelines, test on real devices |
+
+
+## 📑 Content Map
+
+| File | Description | When to Read |
+|------|-------------|--------------|
+| [engineering-spec.md](rules/engineering-spec.md) | Full engineering spec | Architecture review |
+
+---
+
+## 🔗 Related
+
+| Item | Type | Purpose |
+|------|------|---------|
+| `mobile-first` | Skill | Mobile orchestrator |
+| `mobile-design` | Skill | Design patterns |
+| `mobile-security-coder` | Skill | Security implementation |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/mobile-developer/rules/_sections.md

@@ -0,0 +1,75 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Mobile Patterns (mobile)
+
+**Impact:** HIGH  
+**Description:** Mobile-specific patterns for touch, performance, and platform conventions.
+
+## 2. General (general)
+
+**Impact:** LOW  
+**Description:** General patterns and best practices.
+
+## 3. Platform (platform)
+
+**Impact:** LOW  
+**Description:** Platform patterns and best practices.
+
+## 4. Anti (anti)
+
+**Impact:** LOW  
+**Description:** Anti patterns and best practices.
+
+## 5. App store (app-store)
+
+**Impact:** LOW  
+**Description:** App store patterns and best practices.
+
+## 6. Decision Trees (decision)
+
+**Impact:** HIGH  
+**Description:** Structured decision-making frameworks for design choices.
+
+## 7. Deep (deep)
+
+**Impact:** LOW  
+**Description:** Deep patterns and best practices.
+
+## 8. Engineering Specification (engineering)
+
+**Impact:** MEDIUM  
+**Description:** Full engineering specification covering contracts, security, and scalability.
+
+## 9. Mobile color (mobile-color)
+
+**Impact:** LOW  
+**Description:** Mobile color patterns and best practices.
+
+## 10. Mobile design (mobile-design)
+
+**Impact:** LOW  
+**Description:** Mobile design patterns and best practices.
+
+## 11. Push (push)
+
+**Impact:** LOW  
+**Description:** Push patterns and best practices.
+
+## 12. React (react)
+
+**Impact:** LOW  
+**Description:** React patterns and best practices.
+
+## 13. Touch & Interaction (touch)
+
+**Impact:** HIGH  
+**Description:** Touch-first interaction patterns optimized for mobile devices.
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/mobile-developer/rules/_template.md

@@ -0,0 +1,32 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/mobile-developer/rules/anti-patterns.md

@@ -0,0 +1,70 @@
+---
+name: anti-patterns
+description: Quick-reference anti-pattern table for mobile development — performance, UX, security, architecture
+title: "Mobile Anti-Patterns"
+impact: MEDIUM
+impactDescription: "Moderate improvement to quality or maintainability"
+tags: anti, patterns
+---
+
+# Mobile Anti-Patterns
+
+> 🚫 Common AI default tendencies that MUST be avoided!
+
+## Performance Sins
+
+| ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
+|-------------|----------------|--------------|
+| ScrollView for long lists | Renders ALL items, memory explodes | Use `FlatList` / `FlashList` / `ListView.builder` |
+| Inline renderItem function | New function every render | `useCallback` + `React.memo` |
+| Missing keyExtractor | Index-based keys cause bugs | Unique, stable ID from data |
+| Skip getItemLayout | Async layout = janky scroll | Provide when items have fixed height |
+| setState() everywhere | Unnecessary widget rebuilds | Targeted state, `const` constructors |
+| Native driver: false | Animations blocked by JS thread | `useNativeDriver: true` always |
+| console.log in production | Blocks JS thread severely | Remove before release build |
+| Skip React.memo/const | Every item re-renders | Memoize list items ALWAYS |
+
+## Touch/UX Sins
+
+| ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
+|-------------|----------------|--------------|
+| Touch target < 44px | Impossible to tap accurately | Minimum 44pt (iOS) / 48dp (Android) |
+| Spacing < 8px between targets | Accidental taps | Minimum 8-12px gap |
+| Gesture-only interactions | Motor impaired users excluded | Always provide button alternative |
+| No loading state | User thinks app crashed | ALWAYS show loading feedback |
+| No error state | User stuck, no recovery path | Show error with retry option |
+| No offline handling | Crash/block when network lost | Graceful degradation, cached data |
+| Ignore platform conventions | Users confused | iOS feels iOS, Android feels Android |
+
+## Security Sins
+
+| ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
+|-------------|----------------|--------------|
+| Token in AsyncStorage | Easily stolen on rooted device | `SecureStore` / `Keychain` / `EncryptedSharedPreferences` |
+| Hardcode API keys | Reverse engineered from APK/IPA | Environment variables, secure storage |
+| Skip SSL pinning | MITM attacks possible | Pin certificates in production |
+| Log sensitive data | Logs can be extracted | Never log tokens, passwords, PII |
+
+## Architecture Sins
+
+| ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
+|-------------|----------------|--------------|
+| Business logic in UI | Untestable, unmaintainable | Service layer separation |
+| Global state for everything | Unnecessary re-renders | Local state default, lift when needed |
+| Deep linking as afterthought | Notifications, shares broken | Plan deep links from day one |
+| Skip dispose/cleanup | Memory leaks | Clean up subscriptions, timers |
+
+---
+
+## 🔗 Related
+
+| File | When to Read |
+|------|-------------|
+| [mobile-performance.md](mobile-performance.md) | Performance anti-pattern details |
+| [mobile-debugging.md](mobile-debugging.md) | Debugging workflows |
+| [decision-trees.md](decision-trees.md) | Correct patterns to use instead |
+| [touch-psychology.md](touch-psychology.md) | Touch UX guidance |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/mobile-developer/rules/app-store-optimization.md

@@ -0,0 +1,319 @@
+---
+name: app-store-optimization
+description: ASO strategies for iOS App Store and Google Play Store — visibility, conversion, compliance, and automation
+title: "App Store Optimization (ASO)"
+impact: MEDIUM
+impactDescription: "Moderate improvement to quality or maintainability"
+tags: app, store, optimization
+---
+
+# App Store Optimization (ASO)
+
+> **Philosophy:** ASO is SEO for apps. Discoverability drives downloads.
+
+---
+
+## Core ASO Elements
+
+| Element | iOS App Store | Google Play |
+|---------|---------------|-------------|
+| **Title** | 30 chars | 30 chars |
+| **Subtitle** | 30 chars | N/A |
+| **Short Description** | N/A | 80 chars |
+| **Promotional Text** | 170 chars (updateable without review) | N/A |
+| **Keywords** | 100 chars (hidden) | Indexed from all text |
+| **Description** | 4000 chars | 4000 chars |
+| **Screenshots** | Up to 10 | Up to 8 |
+| **Video** | 15-30 sec preview | Up to 30 sec |
+
+---
+
+## Keyword Strategy
+
+### iOS Keyword Field (100 chars)
+
+```
+task,manager,todo,productivity,checklist,reminder,planner,organize,gtd
+```
+
+**Rules:**
+- Comma-separated, no spaces
+- No duplicates (including title words)
+- Singular forms (plurals indexed automatically)
+- No competitor names (rejected)
+
+### Google Play (Text-Based)
+
+Keywords indexed from (highest to lowest weight):
+1. Title
+2. Short description
+3. Full description
+4. Developer name
+
+**Best Practice:** Repeat important keywords 3-5 times naturally in description.
+
+---
+
+## Promotional Text (iOS)
+
+> 170 chars. Can be updated without app review — use for time-sensitive messaging.
+
+| Use Case | Example |
+|----------|---------|
+| Feature launch | "🆕 Dark mode is here! Try it now" |
+| Seasonal | "☀️ Summer sale — 50% off Pro" |
+| Social proof | "⭐ #1 in Productivity — thank you!" |
+| Re-engagement | "📱 New widgets for iOS 18" |
+
+---
+
+## Screenshots That Convert
+
+### Formula: Benefit + Visual
+
+```
+❌ "Home Screen"
+✅ "Track habits effortlessly"
+
+❌ "Settings Page"
+✅ "Customize your experience"
+```
+
+### Screenshot Order
+
+| Position | Purpose |
+|----------|---------|
+| 1-2 | Hook (best features) |
+| 3-4 | Social proof / differentiators |
+| 5+ | Additional features |
+
+### Dimensions
+
+| Device | iOS | Android |
+|--------|-----|---------|
+| Phone | 1290 x 2796 (6.7") | 1080 x 1920 min |
+| Tablet | 2048 x 2732 | 1200 x 1920 |
+
+### Screenshot Automation (fastlane)
+
+```bash
+# iOS — fastlane snapshot
+fastlane snapshot --devices "iPhone 15 Pro Max" --languages "en-US,ja"
+
+# Android — fastlane screengrab
+fastlane screengrab --app_package_name "com.example.myapp"
+```
+
+Config: `Snapfile` (iOS) / `Screengrabfile` (Android)
+
+---
+
+## In-App Events (iOS) & LiveOps (Android)
+
+> Store-featured events that boost visibility and re-engagement.
+
+| Platform | Feature | Duration | Use Case |
+|----------|---------|----------|----------|
+| iOS | In-App Events | 1-30 days | Challenges, new content, live events |
+| Android | LiveOps | Custom | Sales, competitions, updates |
+
+**Best practices:**
+- Use event card image (1920×1080)
+- Time-sensitive events get priority boost
+- Link directly to relevant in-app screen
+
+---
+
+## Custom Product Pages (iOS) / Store Listing Experiments (Android)
+
+| Platform | Feature | Limit |
+|----------|---------|-------|
+| iOS | Custom Product Pages | 35 pages |
+| Android | Store Listing Experiments | A/B testing built-in |
+
+**Use for:** Paid campaigns with audience-specific messaging. Each custom page can have unique screenshots, description, and promotional text.
+
+```
+Campaign A (Fitness audience) → Custom Page with health screenshots
+Campaign B (Students)         → Custom Page with study features
+```
+
+---
+
+## Conversion Rate Optimization
+
+### Icon Best Practices
+
+| Do | Don't |
+|----|-------|
+| Simple, bold design | Complex details |
+| Stand out on white/dark | Blend with background |
+| No text | Tiny unreadable text |
+| Test with A/B | Assume first design works |
+
+### A/B Testing (Google Play Experiments)
+
+Test these in order:
+1. Icon (highest impact)
+2. Screenshots
+3. Short description
+4. Feature graphic
+
+---
+
+## Ratings & Reviews
+
+### Prompting Strategy
+
+```
+WHEN to ask for rating:
+✅ After successful task completion
+✅ After 3+ sessions
+✅ After "happy moment" (achievement, level up)
+
+WHEN NOT to ask:
+❌ During onboarding
+❌ After error/crash
+❌ Too frequently (Apple rejects)
+```
+
+### iOS (SwiftUI — iOS 16+)
+
+```swift
+import StoreKit
+
+// SwiftUI
+@Environment(\.requestReview) private var requestReview
+
+Button("Rate Us") {
+    requestReview()
+}
+
+// UIKit fallback
+if let scene = UIApplication.shared.connectedScenes
+    .first(where: { $0.activationState == .foregroundActive }) as? UIWindowScene {
+    SKStoreReviewController.requestReview(in: scene)
+}
+```
+
+### Responding to Reviews
+
+| Rating | Response Strategy |
+|--------|-------------------|
+| 1-2 ⭐ | Apologize, offer support, request update |
+| 3 ⭐ | Thank, ask what would make it 5-star |
+| 4-5 ⭐ | Thank, mention new features coming |
+
+---
+
+## Localization Impact
+
+| Region | Potential Increase |
+|--------|-------------------|
+| Top 10 languages | +40-80% downloads |
+| Localized screenshots | +25% conversion |
+| Localized keywords | +15% visibility |
+
+**Priority Languages:**
+English (US+UK), Spanish, Portuguese (Brazil), German, French, Japanese, Korean, Chinese (Simplified)
+
+---
+
+## Privacy & Compliance
+
+| Requirement | iOS | Android |
+|-------------|-----|---------|
+| **Privacy labels** | App Privacy section (required) | Data Safety section (required) |
+| **ATT prompt** | `ATTrackingManager.requestTrackingAuthorization` | N/A |
+| **GDPR** | Consent before analytics/ads | Consent before analytics/ads |
+| **COPPA** | If targeting <13, declare in App Store Connect | Declare in Play Console |
+| **Review guidelines** | [Apple Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) | [Google Play Policy](https://play.google.com/about/developer-content-policy/) |
+
+### Common Rejection Reasons (iOS)
+
+| Reason | Fix |
+|--------|-----|
+| 2.1 — App Completeness | No placeholder content, all links working |
+| 2.3 — Accurate Metadata | Screenshots match actual app |
+| 4.0 — Design | Follow HIG, no web-view-only apps |
+| 5.1.1 — Data Collection | Complete privacy labels |
+| 5.1.2 — Data Use | Request only necessary permissions |
+
+---
+
+## Metrics to Track
+
+| Metric | Target | Tool |
+|--------|--------|------|
+| Impression to Page View | > 8% | Store Console |
+| Page View to Install | > 25% | Store Console |
+| Keyword Rankings | Top 10 | Sensor Tower / AppTweak |
+| Organic vs Paid | > 60% organic | Store Console |
+| Day 1 retention | > 25% | Firebase / Adjust |
+
+---
+
+## Metadata Automation (fastlane deliver)
+
+```bash
+# Upload metadata to App Store
+fastlane deliver --skip_binary_upload --skip_screenshots
+
+# Upload metadata to Play Store
+fastlane supply --skip_upload_apk --skip_upload_aab
+```
+
+Directory structure:
+```
+fastlane/metadata/
+├── en-US/
+│   ├── title.txt
+│   ├── subtitle.txt
+│   ├── description.txt
+│   ├── keywords.txt
+│   ├── promotional_text.txt
+│   └── release_notes.txt
+├── ja/
+│   └── ...
+```
+
+---
+
+## Troubleshooting
+
+| Problem | Cause | Fix |
+|---------|-------|-----|
+| Keywords not ranking | Low installs for term | Target less competitive keywords |
+| Conversion dropped | Screenshots outdated | Update with current UI |
+| App rejected | Metadata mismatch | Screenshots must match build |
+| Rating dropping | Bug in recent release | Hotfix + respond to reviews |
+| Not appearing in search | Title too generic | Add category keyword to title |
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|---------|-------|
+| Generic title | Include category + keyword |
+| No keywords in first 3 lines | Front-load important terms |
+| Outdated screenshots | Update with each major release |
+| Ignoring bad reviews | Respond within 24 hours |
+| Skip Promotional Text | Update for every campaign |
+| Ignore privacy labels | Audit quarterly |
+
+---
+
+## 🔗 Related
+
+| File | When to Read |
+|------|-------------|
+| [deep-linking.md](deep-linking.md) | Store listing → app screen routing |
+| [push-notifications.md](push-notifications.md) | Re-engagement after install |
+| [../frameworks/react-native.md](../frameworks/react-native.md) | RN build & EAS Submit |
+| [../frameworks/flutter.md](../frameworks/flutter.md) | Flutter build & Fastlane |
+| [../frameworks/native.md](../frameworks/native.md) | Native build & Xcode Cloud |
+
+---
+
+⚡ PikaKit v3.9.134