@buivietphi/skill-mobile-mt 1.4.0 → 1.4.2

package/AGENTS.md

@@ -62,7 +62,8 @@ skill-mobile-mt/
     ├── release-checklist.md         ← App Store/Play Store checklist (587 tokens)
     │
     ├── offline-first.md             ← Local-first + sync patterns (2,566 tokens)
-    ├── on-device-ai.md              ← Core ML / TFLite / llama.cpp patterns (700 tokens)
+    ├── testing-strategy.md          ← Detox + Maestro + XCUITest + Espresso E2E (2,200 tokens)
+    ├── ci-cd.md                     ← GitHub Actions CI templates (2,500 tokens)
     │
     ├── ── TEMPLATES (copy to your project) ────────────────────
     ├── claude-md-template.md        ← CLAUDE.md for Claude Code (copy to project root)
@@ -71,7 +72,7 @@ skill-mobile-mt/
 
 **Token totals:**
 - Smart load (1 platform + core shared): **~38,600 tokens** (30.2% of 128K)
-- Full load (all files): **~70,000 tokens** (54.7% of 128K)
+- Full load (all files): **~74,700 tokens** (58.4% of 128K)
 
 ---
 
@@ -110,7 +111,8 @@ The agent reads the task, then decides which extra file to load:
 | "Install this package / upgrade SDK" | `shared/version-management.md` |
 | "Prepare for App Store / Play Store" | `shared/release-checklist.md` |
 | "Weird issue, not sure why" | `shared/common-pitfalls.md` |
-| "On-device AI / ML / inference" | `shared/on-device-ai.md` |
+| "Write / run E2E tests" | `shared/testing-strategy.md` |
+| "Setup CI/CD / GitHub Actions" | `shared/ci-cd.md` |
 
 **Load cost:** +500 to +3,500 tokens per on-demand file.
 
@@ -145,7 +147,7 @@ The agent reads the task, then decides which extra file to load:
 ```yaml
 skill:
   name: skill-mobile-mt
-  version: "1.4.0"
+  version: "1.4.2"
   author: buivietphi
   category: engineering
   tags:
@@ -178,7 +180,6 @@ skill:
         # - shared/document-analysis.md
         # - shared/release-checklist.md
         # - shared/common-pitfalls.md
-        # - shared/on-device-ai.md
 
     project:
       description: "Read current project, adapt to its framework and conventions"
@@ -213,9 +214,9 @@ skill:
     java: ".java files in app/src/"
 
   context_budget:
-    max_tokens: 70000
+    max_tokens: 74700
     smart_load_tokens: 38600
-    savings: "~45%"
+    savings: "~48%"
 ```
 
 ---
@@ -261,7 +262,6 @@ Every agent MUST follow this loading sequence:
    - shared/observability.md          (when adding logging, analytics, crash tracking)
    - shared/common-pitfalls.md        (when encountering unfamiliar errors)
    - shared/release-checklist.md      (when preparing for App Store/Play Store submission)
-   - shared/on-device-ai.md           (when adding Core ML / TFLite / on-device inference)
 
 7. SKIP non-matching platform subfolders (saves ~66% context)
 ```
@@ -283,7 +283,8 @@ Priority 6 (ON-DEMAND): shared/observability.md — Sessions as 4th pillar
 Priority 6 (ON-DEMAND): shared/document-analysis.md — Parse images/PDFs → code
 Priority 6 (ON-DEMAND): shared/release-checklist.md — Pre-release verification
 Priority 6 (ON-DEMAND): shared/common-pitfalls.md — Known issue patterns
-Priority 6 (ON-DEMAND): shared/on-device-ai.md — Core ML / TFLite / llama.cpp
+Priority 6 (ON-DEMAND): shared/testing-strategy.md — Detox + Maestro + XCUITest + Espresso E2E
+Priority 6 (ON-DEMAND): shared/ci-cd.md — GitHub Actions CI/CD templates
 ```
 
 ---

package/README.md

@@ -232,7 +232,7 @@ iOS only?
 | SKILL.md only | ~13,200 | 10.3% | 6.6% |
 | + 1 platform + core shared/ | ~38,600 | 30.2% | 19.3% |
 | Cross-platform (RN/Flutter + iOS + Android) | ~53,000 | 41.4% | 26.5% |
-| All files loaded | ~70,000 | 54.7% | 35.0% |
+| All files loaded | ~74,700 | 58.4% | 37.4% |
 | **Smart load (recommended)** | **~38,600** | **30.2%** | **19.3%** |
 
 ### Per-file token breakdown
@@ -259,10 +259,11 @@ iOS only?
 | `shared/version-management.md` | 3,500 |
 | `shared/observability.md` | 3,000 |
 | `shared/offline-first.md` | 2,566 |
-| `shared/on-device-ai.md` | 700 |
+| `shared/testing-strategy.md` | 2,200 |
+| `shared/ci-cd.md` | 2,500 |
 | `shared/claude-md-template.md` | ~500 |
 | `shared/agent-rules-template.md` | ~2,500 |
-| **Total** | **~49,500** |
+| **Total** | **~53,500** |
 
 ## Installed Structure
 
@@ -294,7 +295,8 @@ iOS only?
         ├── observability.md           Sessions as 4th pillar
         ├── release-checklist.md       Pre-release verification
         ├── offline-first.md           Local-first + sync patterns
-        ├── on-device-ai.md            Core ML / TFLite / llama.cpp
+        ├── testing-strategy.md        Detox + Maestro + XCUITest + Espresso E2E
+        ├── ci-cd.md                   GitHub Actions CI/CD templates
         ├── claude-md-template.md      CLAUDE.md template for projects
         └── agent-rules-template.md    Rules templates for all agents
 ```
@@ -390,7 +392,6 @@ your-project/
 - **Anti-Pattern Detection** (`anti-patterns.md`): Detect PII leaks (CRITICAL), high cardinality tags, unbounded payloads, unstructured logs, sync telemetry on main thread — with auto-fix suggestions
 - **Performance Prediction** (`performance-prediction.md`): Calculate frame budget, FlatList bridge calls, and memory usage BEFORE writing code. Example: `50 items × 3 bridge calls × 0.3ms = 45ms/frame → 22 FPS ❌ JANK`
 - **Platform Excellence** (`platform-excellence.md`): iOS 18+ vs Android 15+ native UX standards — navigation patterns, typography, haptic feedback types, permission timing, ratings prompt flow, Live Activities/Dynamic Island, performance targets (cold start < 1s iOS, < 1.5s Android)
-- **On-Device AI** (`on-device-ai.md`): Decision matrix (API vs on-device), Core ML (iOS), ML Kit + MediaPipe (Android), llama.cpp cross-platform, TFLite Flutter, React Native ML Kit — with performance rules and model size guidance
 - **Version Management** (`version-management.md`): Full SDK compatibility matrix for RN 0.73-0.76, Expo 50-52, Flutter 3.22-3.27, iOS 16-18, Android 13-15. Check SDK compat BEFORE `npm install`. Release-mode testing protocol.
 - **Observability** (`observability.md`): Sessions as the 4th pillar (Metrics + Logs + Traces + **Sessions**). Session lifecycle, enrichment API, unified instrumentation stack, correlation queries. Every event carries `session_id` for full user journey reconstruction.
 

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: skill-mobile-mt
 description: "Master Senior Mobile Engineer. Patterns from 30+ production repos (200k+ GitHub stars: Ignite, Expensify, Mattermost, Immich, AppFlowy, Now in Android, TCA). Use when: building mobile features, fixing mobile bugs, reviewing mobile code, mobile architecture, React Native, Flutter, iOS Swift, Android Kotlin, mobile performance, mobile security audit, mobile code review, app release. Two modes: (1) default = pre-built production patterns, (2) 'project' = reads current project and adapts."
-version: "1.4.0"
+version: "1.4.2"
 author: buivietphi
 priority: high
 user-invocable: true
@@ -130,8 +130,11 @@ USER REQUEST                    → ACTION (Read tool required)
 "Offline / cache / sync"        → Read: shared/offline-first.md
                                   then: implement local-first architecture
 
-"On-device AI / ML / inference" → Read: shared/on-device-ai.md
-                                  then: choose Core ML / TFLite / llama.cpp per platform
+"Write/run E2E tests"           → Read: shared/testing-strategy.md
+                                  then: Detox (RN) or Maestro (cross-platform) or XCUITest/Espresso
+
+"Setup CI/CD / GitHub Actions"  → Read: shared/ci-cd.md
+                                  then: test → build → distribute pipeline
 
 ```
 

package/bin/install.mjs

@@ -70,7 +70,7 @@ const fail = m => log(`  ${c.red}✗${c.reset} ${m}`);
 
 function banner() {
   log(`\n${c.bold}${c.cyan}  ┌──────────────────────────────────────────────────┐`);
-  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.0           │`);
+  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.2           │`);
   log(`  │  Master Senior Mobile Engineer                    │`);
   log(`  │                                                  │`);
   log(`  │  Claude · Cline · Roo Code · Cursor · Windsurf  │`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buivietphi/skill-mobile-mt",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Master Senior Mobile Engineer skill for AI agents. Pre-built patterns from 18 production apps + local project adaptation. React Native, Flutter, iOS, Android. Supports Claude, Gemini, Kimi, Cursor, Copilot, Antigravity.",
   "author": "buivietphi",
   "license": "MIT",

package/shared/ci-cd.md

@@ -0,0 +1,423 @@
+# CI/CD Pipelines — GitHub Actions for Mobile
+
+> Automate: test → build → distribute. Never ship without CI.
+
+---
+
+## React Native — CI Pipeline
+
+```yaml
+# .github/workflows/rn-ci.yml
+name: React Native CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'           # or npm, pnpm
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: TypeScript check
+        run: yarn tsc --noEmit
+
+      - name: Lint
+        run: yarn lint
+
+      - name: Unit tests
+        run: yarn test --ci --coverage --maxWorkers=2
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  build-android:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Cache Gradle
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*') }}
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Build Android APK (debug)
+        run: cd android && ./gradlew assembleDebug
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: app-debug.apk
+          path: android/app/build/outputs/apk/debug/app-debug.apk
+
+  build-ios:
+    runs-on: macos-15
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Cache CocoaPods
+        uses: actions/cache@v4
+        with:
+          path: ios/Pods
+          key: ${{ runner.os }}-pods-${{ hashFiles('ios/Podfile.lock') }}
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile && cd ios && pod install
+
+      - name: Build iOS (simulator)
+        run: |
+          xcodebuild -workspace ios/MyApp.xcworkspace \
+            -scheme MyApp \
+            -sdk iphonesimulator \
+            -configuration Debug \
+            -derivedDataPath ios/build \
+            CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO
+```
+
+---
+
+## React Native — E2E with Detox
+
+```yaml
+# .github/workflows/rn-e2e.yml
+name: E2E Tests (Detox)
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  e2e-ios:
+    runs-on: macos-15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile && cd ios && pod install
+
+      - name: Install Detox CLI
+        run: npm install -g detox-cli
+
+      - name: Build for Detox
+        run: detox build --configuration ios.sim.debug
+
+      - name: Run E2E tests
+        run: detox test --configuration ios.sim.debug --headless
+
+      - name: Upload Detox artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: detox-artifacts
+          path: artifacts/
+```
+
+---
+
+## Flutter — CI Pipeline
+
+```yaml
+# .github/workflows/flutter-ci.yml
+name: Flutter CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.x'
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Analyze
+        run: flutter analyze
+
+      - name: Unit + Widget tests
+        run: flutter test --coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+
+  build-android:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.x'
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build APK
+        run: flutter build apk --debug
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: flutter-debug.apk
+          path: build/app/outputs/flutter-apk/app-debug.apk
+
+  build-ios:
+    runs-on: macos-15
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.x'
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build iOS (no codesign)
+        run: flutter build ios --debug --no-codesign
+```
+
+---
+
+## iOS — Release to TestFlight (Fastlane)
+
+```yaml
+# .github/workflows/ios-release.yml
+name: iOS Release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: macos-15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile && cd ios && pod install
+
+      - name: Setup certificates
+        uses: apple-actions/import-codesign-certs@v2
+        with:
+          p12-file-base64: ${{ secrets.CERTIFICATES_P12 }}
+          p12-password: ${{ secrets.CERTIFICATES_P12_PASSWORD }}
+
+      - name: Setup provisioning profile
+        uses: apple-actions/download-provisioning-profiles@v1
+        with:
+          bundle-id: com.myapp
+          issuer-id: ${{ secrets.APPSTORE_ISSUER_ID }}
+          api-key-id: ${{ secrets.APPSTORE_KEY_ID }}
+          api-private-key: ${{ secrets.APPSTORE_PRIVATE_KEY }}
+
+      - name: Deploy to TestFlight
+        run: bundle exec fastlane ios beta
+        env:
+          APP_STORE_CONNECT_API_KEY_KEY_ID: ${{ secrets.APPSTORE_KEY_ID }}
+          APP_STORE_CONNECT_API_KEY_ISSUER_ID: ${{ secrets.APPSTORE_ISSUER_ID }}
+          APP_STORE_CONNECT_API_KEY_KEY: ${{ secrets.APPSTORE_PRIVATE_KEY }}
+```
+
+```ruby
+# ios/Fastfile
+lane :beta do
+  build_app(
+    workspace: "MyApp.xcworkspace",
+    scheme: "MyApp",
+    configuration: "Release",
+    export_method: "app-store"
+  )
+  upload_to_testflight(skip_waiting_for_build_processing: true)
+end
+```
+
+---
+
+## Android — Release to Play Store (Fastlane)
+
+```yaml
+# .github/workflows/android-release.yml
+name: Android Release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Decode keystore
+        run: echo "${{ secrets.KEYSTORE_BASE64 }}" | base64 -d > android/app/release.keystore
+
+      - name: Build release AAB
+        run: cd android && ./gradlew bundleRelease
+        env:
+          KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
+          KEY_ALIAS: ${{ secrets.KEY_ALIAS }}
+          KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
+
+      - name: Deploy to Play Store
+        uses: r0adkll/upload-google-play@v1
+        with:
+          serviceAccountJsonPlainText: ${{ secrets.PLAY_STORE_SERVICE_ACCOUNT_JSON }}
+          packageName: com.myapp
+          releaseFiles: android/app/build/outputs/bundle/release/*.aab
+          track: internal
+```
+
+---
+
+## Required GitHub Secrets
+
+```
+# iOS
+CERTIFICATES_P12             ← base64-encoded .p12 file
+CERTIFICATES_P12_PASSWORD    ← password for .p12
+APPSTORE_KEY_ID              ← App Store Connect API key ID
+APPSTORE_ISSUER_ID           ← App Store Connect issuer ID
+APPSTORE_PRIVATE_KEY         ← App Store Connect private key (.p8 contents)
+
+# Android
+KEYSTORE_BASE64              ← base64-encoded release.keystore
+KEYSTORE_PASSWORD            ← keystore password
+KEY_ALIAS                    ← key alias
+KEY_PASSWORD                 ← key password
+PLAY_STORE_SERVICE_ACCOUNT_JSON  ← GCP service account JSON
+
+# Shared
+CODECOV_TOKEN                ← coverage reporting
+MAESTRO_API_KEY              ← Maestro Cloud E2E (optional)
+```
+
+---
+
+## Caching Strategy
+
+```yaml
+# Node modules — hash package-lock or yarn.lock
+- uses: actions/cache@v4
+  with:
+    path: node_modules
+    key: ${{ runner.os }}-node-${{ hashFiles('**/yarn.lock') }}
+    restore-keys: ${{ runner.os }}-node-
+
+# Gradle — hash .gradle files
+- uses: actions/cache@v4
+  with:
+    path: |
+      ~/.gradle/caches
+      ~/.gradle/wrapper
+    key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+
+# CocoaPods — hash Podfile.lock
+- uses: actions/cache@v4
+  with:
+    path: ios/Pods
+    key: ${{ runner.os }}-pods-${{ hashFiles('ios/Podfile.lock') }}
+
+# Flutter pub — hash pubspec.lock
+- uses: actions/cache@v4
+  with:
+    path: ~/.pub-cache
+    key: ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.lock') }}
+```
+
+---
+
+## Anti-Patterns
+
+```
+❌ Committing signing credentials to repo
+❌ Running E2E on every PR (too slow — run on main only)
+❌ No caching (3x slower builds)
+❌ Skipping unit tests before build jobs
+❌ Building on push to every branch
+
+✅ Store all secrets in GitHub Secrets
+✅ Cache node_modules + Gradle + CocoaPods + pub-cache
+✅ Unit tests on PR, E2E on merge to main
+✅ needs: test before build jobs
+✅ Upload build artifacts for download/QA
+```

package/shared/testing-strategy.md

@@ -0,0 +1,332 @@
+# Mobile Testing Strategy — Unit + E2E
+
+> Test the right things at the right layer. Don't test implementation details.
+
+---
+
+## Testing Pyramid
+
+```
+        ╱ E2E ╲          ← Detox / Maestro / XCUITest / Espresso
+       ╱───────╲         ← Few, slow, high-confidence
+      ╱Integration╲      ← API mocking, navigation flows
+     ╱─────────────╲     ← Medium count
+    ╱   Unit Tests   ╲   ← Jest / XCTest / JUnit
+   ╱─────────────────╲   ← Many, fast, cheap
+
+RULE: Most tests = unit. E2E = critical flows only (login, checkout, onboarding).
+```
+
+---
+
+## Unit Tests (Jest — React Native / TypeScript)
+
+```typescript
+// Test hooks, not components
+describe('useCart', () => {
+  it('adds item and updates total', () => {
+    const { result } = renderHook(() => useCart(), { wrapper: ReduxProvider })
+    act(() => { result.current.addItem(mockProduct) })
+    expect(result.current.total).toBe(mockProduct.price)
+  })
+
+  it('handles addToCart API error with rollback', async () => {
+    server.use(rest.post('/cart', (req, res, ctx) => res(ctx.status(500))))
+    const { result } = renderHook(() => useCart(), { wrapper: ReduxProvider })
+    await act(async () => { await result.current.addItem(mockProduct) })
+    expect(result.current.items).toHaveLength(0) // rolled back
+    expect(result.current.error).toBeTruthy()
+  })
+})
+
+// Test Redux slices directly
+describe('cartSlice', () => {
+  it('sets loading state on fetchCart.pending', () => {
+    const state = cartReducer(initialState, fetchCart.pending('', undefined))
+    expect(state.status).toBe('loading')
+  })
+})
+```
+
+**Rules:**
+- Test business logic (hooks, services, slices) — NOT component layout
+- Mock API calls with `msw` (Mock Service Worker)
+- 4 states per feature: loading / success / error / empty
+
+---
+
+## E2E Testing — Detox (React Native)
+
+> Best for: React Native apps, full native bridge testing.
+
+### Setup
+
+```bash
+# Install
+npm install --save-dev detox @config/detox
+
+# iOS build (required before tests)
+detox build --configuration ios.sim.debug
+
+# Run tests
+detox test --configuration ios.sim.debug
+detox test --configuration android.emu.debug
+```
+
+### Config (`detox.config.js`)
+
+```js
+module.exports = {
+  testRunner: {
+    args: { '$0': 'jest', config: 'e2e/jest.config.js' },
+    jest: { setupTimeout: 120000 }
+  },
+  apps: {
+    'ios.debug': { type: 'ios.app', binaryPath: 'ios/build/Build/Products/Debug-iphonesimulator/MyApp.app', build: 'xcodebuild -workspace ios/MyApp.xcworkspace -scheme MyApp -configuration Debug -sdk iphonesimulator -derivedDataPath ios/build' },
+    'android.debug': { type: 'android.apk', binaryPath: 'android/app/build/outputs/apk/debug/app-debug.apk', build: 'cd android && ./gradlew assembleDebug assembleAndroidTest -DtestBuildType=debug' }
+  },
+  devices: {
+    simulator: { type: 'ios.simulator', device: { type: 'iPhone 15' } },
+    emulator: { type: 'android.emulator', device: { avdName: 'Pixel_7_API_34' } }
+  },
+  configurations: {
+    'ios.sim.debug': { device: 'simulator', app: 'ios.debug' },
+    'android.emu.debug': { device: 'emulator', app: 'android.debug' }
+  }
+}
+```
+
+### Write Detox Tests
+
+```typescript
+// e2e/login.test.ts
+describe('Login Flow', () => {
+  beforeAll(async () => {
+    await device.launchApp({ newInstance: true })
+  })
+
+  beforeEach(async () => {
+    await device.reloadReactNative()
+  })
+
+  it('shows error on wrong password', async () => {
+    await element(by.id('email-input')).typeText('user@test.com')
+    await element(by.id('password-input')).typeText('wrongpass')
+    await element(by.id('login-button')).tap()
+    await expect(element(by.text('Invalid credentials'))).toBeVisible()
+  })
+
+  it('navigates to home on success', async () => {
+    await element(by.id('email-input')).typeText('user@test.com')
+    await element(by.id('password-input')).typeText('correctpass')
+    await element(by.id('login-button')).tap()
+    await expect(element(by.id('home-screen'))).toBeVisible()
+  })
+})
+```
+
+**testID rules:**
+```typescript
+// Add testID to interactive elements
+<TextInput testID="email-input" ... />
+<TouchableOpacity testID="login-button" ... />
+<View testID="home-screen" ... />
+```
+
+**What to test with Detox:**
+- Login / logout flow
+- Onboarding (first-time user)
+- Critical purchase / checkout path
+- Push notification tap → navigation
+- Deep link handling
+
+**What NOT to test with Detox:** minor UI variations, loading spinners, animations.
+
+---
+
+## E2E Testing — Maestro (Cross-Platform)
+
+> Best for: Simpler setup, works on React Native + Flutter + native iOS/Android.
+
+### Setup
+
+```bash
+# macOS
+brew tap mobile-dev-inc/tap
+brew install maestro
+
+# Run a flow
+maestro test e2e/login.yaml
+maestro test e2e/           # all flows in folder
+```
+
+### Write Maestro Flows (YAML)
+
+```yaml
+# e2e/login.yaml
+appId: com.myapp
+---
+- launchApp:
+    clearState: true
+
+- assertVisible: "Sign In"
+
+- tapOn:
+    id: "email-input"
+- inputText: "user@test.com"
+
+- tapOn:
+    id: "password-input"
+- inputText: "wrongpass"
+
+- tapOn:
+    id: "login-button"
+
+- assertVisible: "Invalid credentials"
+```
+
+```yaml
+# e2e/checkout.yaml
+appId: com.myapp
+---
+- launchApp
+- tapOn: "Products"
+- tapOn:
+    index: 0   # first product
+- tapOn: "Add to Cart"
+- tapOn: "Checkout"
+- assertVisible: "Order Confirmed"
+```
+
+### Maestro Cloud CI
+
+```bash
+# Run on real devices in Maestro Cloud
+maestro cloud --apiKey $MAESTRO_API_KEY e2e/
+```
+
+**Maestro vs Detox:**
+
+| | Maestro | Detox |
+|--|---------|-------|
+| Setup | Minutes | Hours |
+| YAML / Code | YAML | TypeScript |
+| Cross-platform | ✅ RN + Flutter + native | RN only |
+| Speed | Slower | Faster |
+| Power | Medium | High |
+| CI integration | Maestro Cloud | Self-hosted |
+
+**Use Maestro when:** simple flows, cross-platform team, quick setup.
+**Use Detox when:** complex interactions, React Native only, full control.
+
+---
+
+## Flutter Testing
+
+### Unit + Widget Tests
+
+```dart
+// Unit test — business logic
+test('CartBloc adds item correctly', () {
+  final bloc = CartBloc(cartRepository: MockCartRepository());
+  bloc.add(AddToCart(product: mockProduct));
+  expectLater(bloc.stream, emits(CartLoaded(items: [mockProduct])));
+});
+
+// Widget test — UI
+testWidgets('ProductCard shows title and price', (tester) async {
+  await tester.pumpWidget(MaterialApp(
+    home: ProductCard(product: mockProduct),
+  ));
+  expect(find.text(mockProduct.title), findsOneWidget);
+  expect(find.text('\$${mockProduct.price}'), findsOneWidget);
+});
+```
+
+### Integration Test (Flutter Driver replacement)
+
+```dart
+// integration_test/login_test.dart
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('login flow', (tester) async {
+    app.main();
+    await tester.pumpAndSettle();
+
+    await tester.enterText(find.byKey(Key('email')), 'user@test.com');
+    await tester.enterText(find.byKey(Key('password')), 'pass123');
+    await tester.tap(find.byKey(Key('login-button')));
+    await tester.pumpAndSettle();
+
+    expect(find.byKey(Key('home-screen')), findsOneWidget);
+  });
+}
+```
+
+```bash
+# Run on simulator
+flutter test integration_test/
+
+# Run on real device
+flutter test integration_test/ -d <device-id>
+```
+
+---
+
+## iOS — XCUITest
+
+```swift
+func testLoginFlow() throws {
+    let app = XCUIApplication()
+    app.launch()
+
+    let emailField = app.textFields["email-input"]
+    emailField.tap()
+    emailField.typeText("user@test.com")
+
+    let passwordField = app.secureTextFields["password-input"]
+    passwordField.tap()
+    passwordField.typeText("pass123")
+
+    app.buttons["login-button"].tap()
+
+    XCTAssertTrue(app.otherElements["home-screen"].waitForExistence(timeout: 5))
+}
+```
+
+---
+
+## Android — Espresso
+
+```kotlin
+@Test
+fun testLoginFlow() {
+    onView(withId(R.id.emailInput))
+        .perform(typeText("user@test.com"), closeSoftKeyboard())
+    onView(withId(R.id.passwordInput))
+        .perform(typeText("pass123"), closeSoftKeyboard())
+    onView(withId(R.id.loginButton)).perform(click())
+    onView(withId(R.id.homeScreen)).check(matches(isDisplayed()))
+}
+```
+
+---
+
+## Anti-Patterns
+
+```
+❌ Testing implementation details (internal state, private methods)
+❌ Testing every UI pixel (visual regression belongs in Storybook/Percy)
+❌ E2E for every edge case (unit test those)
+❌ Skipping testID on interactive elements
+❌ Running Detox without a stable test build
+❌ Using sleep() instead of waitFor()
+
+✅ Test user flows, not code internals
+✅ E2E for critical paths: login, purchase, onboarding
+✅ Unit test all business logic (hooks, slices, services)
+✅ Mock API calls in unit tests
+✅ Add testID to every tappable + input element
+✅ waitFor() over sleep() in Detox
+```

package/shared/on-device-ai.md

@@ -1,175 +0,0 @@
-# On-Device AI — Mobile ML Integration
-
-> On-demand. Load when: "on-device AI", "ML model", "Core ML", "TFLite", "MediaPipe", "llama", "inference", "local model"
-> Source: llama.cpp, Core ML, MediaPipe, TensorFlow Lite
-
----
-
-## Decision Matrix
-
-```
-Use case                           Solution
-───────────────────────────────────────────────────────────
-Image classification / OCR         Core ML (iOS) / ML Kit (Android)
-Text classification / sentiment     Core ML NLP / ML Kit
-Face detection / pose estimation   Vision (iOS) / MediaPipe
-On-device LLM chat (<7B params)    llama.cpp / llama.rn / executorch
-Cloud LLM (>7B / latest models)    API call — don't run on device
-Real-time object detection         Core ML / TFLite + MediaPipe
-Speech to text (on-device)         SFSpeechRecognizer (iOS) / ML Kit (Android)
-
-Rule: If model > 500MB → use API. If latency > 3s acceptable → use API.
-```
-
----
-
-## iOS — Core ML
-
-```swift
-// 1. Import model (drag .mlpackage into Xcode)
-import CoreML
-import Vision
-
-// 2. Image classification
-let model = try VNCoreMLModel(for: MyClassifier(configuration: .init()).model)
-let request = VNCoreMLRequest(model: model) { request, _ in
-    guard let results = request.results as? [VNClassificationObservation] else { return }
-    let top = results.first!
-    print("\(top.identifier): \(top.confidence)")
-}
-let handler = VNImageRequestHandler(cgImage: image, options: [:])
-try handler.perform([request])
-
-// 3. NLP text classification
-import NaturalLanguage
-let classifier = NLModel(mlModel: SentimentClassifier().model)
-let label = classifier.predictedLabel(for: "This is great!")
-
-// Model conversion: use coremltools Python package
-// coremltools.convert(pytorch_model, inputs=[...])
-```
-
----
-
-## Android — ML Kit + MediaPipe
-
-```kotlin
-// ML Kit — text recognition (no model download needed)
-dependencies {
-    implementation("com.google.mlkit:text-recognition:16.0.0")
-    implementation("com.google.mlkit:face-detection:16.1.5")
-}
-
-val recognizer = TextRecognition.getClient(TextRecognizerOptions.DEFAULT_OPTIONS)
-recognizer.process(inputImage)
-    .addOnSuccessListener { result -> result.text }
-    .addOnFailureListener { e -> /* handle */ }
-
-// MediaPipe — pose / hand / face landmark detection
-dependencies {
-    implementation("com.google.mediapipe:tasks-vision:0.10.14")
-}
-
-val handLandmarker = HandLandmarker.createFromOptions(context,
-    HandLandmarkerOptions.builder()
-        .setBaseOptions(BaseOptions.builder().setModelAssetPath("hand_landmarker.task").build())
-        .setNumHands(2)
-        .build()
-)
-```
-
----
-
-## On-Device LLM — llama.cpp (Cross-Platform)
-
-```
-Model sizes (GGUF Q4_K_M quantization):
-  Llama 3.2 3B   → ~2GB RAM  ✅ Phone-friendly
-  Llama 3.1 8B   → ~5GB RAM  ⚠️ High-end only (iPhone 15 Pro, Pixel 9)
-  Llama 3.1 70B  → ~40GB RAM ❌ Not feasible on device
-
-Download: huggingface.co/models?search=gguf
-```
-
-```swift
-// iOS — llama.swift
-// https://github.com/ggerganov/llama.cpp (Swift bindings included)
-import llama
-
-let model = llama_load_model_from_file(modelPath, llama_model_default_params())
-let ctx = llama_new_context_with_model(model, llama_context_default_params())
-// Tokenize + run inference on background thread
-```
-
-```javascript
-// React Native — llama.rn
-// npm install llama.rn
-import { LlamaContext } from 'llama.rn';
-
-const context = await LlamaContext.create({
-  model: `${RNFS.DocumentDirectoryPath}/model.gguf`,
-  n_ctx: 2048,
-  n_threads: 4,
-});
-const result = await context.completion({ prompt: 'Hello!', n_predict: 100 });
-```
-
-```dart
-// Flutter — flutter_llama (or use Platform.channel to llama.cpp)
-// For production: use executorch (Meta) or llama.cpp via FFI
-```
-
----
-
-## React Native — ML Kit (via react-native-mlkit)
-
-```javascript
-// npm install @infinitered/react-native-mlkit-core
-// npm install @infinitered/react-native-mlkit-object-detection
-
-import { ObjectDetectionCamera } from '@infinitered/react-native-mlkit-object-detection';
-
-// Image labeling
-import MLKitImageLabeling from '@react-native-ml-kit/image-labeling';
-const labels = await MLKitImageLabeling.label(imageUri);
-// Returns: [{ text: 'Cat', confidence: 0.95 }]
-```
-
----
-
-## Flutter — tflite_flutter
-
-```dart
-// pubspec.yaml: tflite_flutter: ^0.10.4
-import 'package:tflite_flutter/tflite_flutter.dart';
-
-final interpreter = await Interpreter.fromAsset('model.tflite');
-final input = [imageData];  // pre-processed tensor
-final output = List.filled(1000, 0).reshape([1, 1000]);
-interpreter.run(input, output);
-// output[0] = probability for each class
-```
-
----
-
-## Performance Rules
-
-```
-1. NEVER run inference on the main thread
-   iOS: DispatchQueue.global(qos: .userInitiated).async { ... }
-   Android: viewModelScope.launch(Dispatchers.Default) { ... }
-   RN: run on JS thread or use NativeModule
-
-2. Load model ONCE — cache in memory
-   ❌ Load model on every inference call
-   ✅ Load at app start or first use, keep reference
-
-3. Batch requests when possible
-   - Process images in background queue, not per-tap
-
-4. Show progress for operations >500ms
-   - Spinner or progress bar — user expects AI to take a moment
-
-5. Fallback to API if device is low on memory
-   let memoryPressure = ProcessInfo.processInfo.isLowPowerModeEnabled
-```