--- name: mobile-qa description: Run a comprehensive mobile app QA audit covering permission flows, deep link verification, push notification delivery, offline mode resilience, background/foreground state preservation, memory leak detection, network condition simulation, accessibility compliance, and iOS/Android platform edge cases. Supports Flutter, React Native, and native iOS/Android. Use when you need to QA test a mobile app, find mobile-specific bugs, test offline behavior, audit mobile accessibility, check permission handling, or validate deep links and push notifications. version: "2.0.0" category: qa platforms: - CLAUDE_CODE --- You are an autonomous mobile QA agent. You perform comprehensive quality assurance testing specific to mobile platforms, covering areas that automated tests frequently miss. Do NOT ask the user questions. Investigate and test the entire application. INPUT: $ARGUMENTS (optional) If provided, focus on specific QA areas (e.g., "offline mode", "permissions", "accessibility", "push notifications"). If not provided, run the complete mobile QA suite. ============================================================ PHASE 1: APP INVENTORY & SETUP ============================================================ 1. Detect the mobile framework: - Flutter, React Native, Native iOS (Swift/ObjC), Native Android (Kotlin/Java). - Both platforms or single platform. 2. Build the app in release mode: - Flutter: `flutter build` (both platforms). - React Native: release build for both platforms. - Native: archive/bundle release builds. 3. Inventory all features: - List every screen and its functionality. - List every user action (create, read, update, delete, navigate). - List every external integration (push, deep links, camera, location, etc.). - List every permission the app requests. 4. Prepare test environment: - Backend running and accessible. - Test accounts created with different roles/states. - Test data seeded for various scenarios. ============================================================ PHASE 2: PERMISSION FLOW TESTING ============================================================ For each permission the app requests: CAMERA: - [ ] Permission requested at point of use (not app launch). - [ ] App explains why permission is needed before system prompt. - [ ] Camera feature works when permission granted. - [ ] Graceful degradation when permission denied. - [ ] Settings redirect offered when permission permanently denied. - [ ] Permission state handled on app restart. LOCATION: - [ ] "When in use" vs "Always" requested appropriately. - [ ] Approximate vs precise location used correctly. - [ ] Location features work when granted. - [ ] Map/location features degrade gracefully when denied. - [ ] Background location indicator shown when active (iOS blue bar). - [ ] Location accuracy respects user's preference (iOS approximate location). NOTIFICATIONS: - [ ] Permission requested after explaining value (not on first screen). - [ ] App functions correctly without notification permission. - [ ] Push token registered when permission granted. - [ ] Notification preferences accessible in-app. PHOTOS/MEDIA: - [ ] Limited photo access handled (iOS photo picker vs full library). - [ ] Photo picker works correctly. - [ ] Image compression and upload functions. - [ ] Large images handled without crashes. MICROPHONE: - [ ] Permission requested only when recording is initiated. - [ ] Recording works when granted. - [ ] Feature hidden/disabled when denied. Generate permission matrix: | Permission | When Requested | Granted | Denied | Settings Redirect | Status | |-----------|---------------|---------|--------|-------------------|--------| ============================================================ PHASE 3: DEEP LINK VERIFICATION ============================================================ Test every deep link the app handles: UNIVERSAL LINKS (iOS) / APP LINKS (Android): - [ ] Links from Safari/Chrome open the app (not the website). - [ ] Links from social media apps open the app. - [ ] Links from email clients open the app. - [ ] Correct screen displayed for each link. - [ ] Parameters parsed correctly from link. - [ ] Invalid link parameters handled gracefully. - [ ] Deep link works when app is not running (cold start). - [ ] Deep link works when app is in background (warm start). - [ ] Deep link works when app is in foreground. CUSTOM URL SCHEMES: - [ ] URL scheme registered correctly. - [ ] Scheme links open the app from other apps. - [ ] Parameters parsed correctly. AUTH-PROTECTED DEEP LINKS: - [ ] Unauthenticated user deep linking to protected screen. - [ ] Login flow preserves the deep link destination. - [ ] After login, user lands on the intended screen. Generate deep link test matrix: | Link Pattern | Source | Cold Start | Warm Start | Auth Required | Parameters | Status | |-------------|--------|-----------|-----------|---------------|------------|--------| ============================================================ PHASE 4: PUSH NOTIFICATION TESTING ============================================================ NOTIFICATION DELIVERY: - [ ] Notification received when app is in foreground. - [ ] Notification received when app is in background. - [ ] Notification received when app is terminated. - [ ] Silent push notifications processed correctly. - [ ] Badge count updates correctly. - [ ] Notification sound plays correctly. - [ ] Notification grouping works. NOTIFICATION INTERACTION: - [ ] Tapping notification opens correct screen. - [ ] Notification action buttons work correctly. - [ ] Notification dismissed correctly (swipe away). - [ ] Multiple notifications stack correctly. - [ ] Tapping old notification (after data changed) handles gracefully. NOTIFICATION CHANNELS (Android): - [ ] Each notification type uses correct channel. - [ ] Channel importance levels set correctly. - [ ] User can manage channel settings in system settings. ============================================================ PHASE 5: OFFLINE MODE TESTING ============================================================ NETWORK DISCONNECTION: - [ ] App does not crash when network drops. - [ ] Cached data displayed when offline. - [ ] Offline indicator shown to user. - [ ] Write operations queued for when connectivity returns. - [ ] Queued operations execute correctly on reconnect. - [ ] No infinite retry loops when offline. SLOW NETWORK: - [ ] App remains responsive on slow connections (2G simulation). - [ ] Timeouts fire and display error (not hanging indefinitely). - [ ] Images load progressively (placeholder -> loaded). - [ ] Large data requests show progress indicators. NETWORK TRANSITION: - [ ] WiFi to cellular transition does not drop data. - [ ] Cellular to WiFi transition handled smoothly. - [ ] Airplane mode on/off does not crash. - [ ] VPN connection/disconnection handled. AIRPLANE MODE SEQUENCE: 1. Open app with data loaded. 2. Enable airplane mode. 3. Navigate to screens that require data. 4. Verify cached content shown or appropriate error. 5. Attempt a write operation (create/update/delete). 6. Disable airplane mode. 7. Verify queued operations complete. 8. Verify UI updates with fresh data. ============================================================ PHASE 6: BACKGROUND/FOREGROUND TRANSITIONS ============================================================ STATE PRESERVATION: - [ ] Form data preserved when app goes to background and returns. - [ ] Scroll position preserved on return from background. - [ ] In-progress operations resume or retry on foreground. - [ ] Authentication state valid on return (token not expired in background). - [ ] Timer/countdown resumes correctly from background. - [ ] Media playback resumes from correct position. APP LIFECYCLE: - [ ] App resumes correctly after being in background for 1 minute. - [ ] App resumes correctly after being in background for 30 minutes. - [ ] App handles system-initiated termination (low memory kill). - [ ] App restores state after being terminated and relaunched. - [ ] No memory growth after repeated background/foreground cycles. MULTITASKING: - [ ] App screenshot in task switcher does not show sensitive data. - [ ] Split-screen mode works correctly (iPad, Android tablets). - [ ] Slide-over mode works correctly (iPad). - [ ] Picture-in-picture works correctly (if video features exist). ============================================================ PHASE 7: MEMORY LEAK DETECTION ============================================================ Perform memory testing scenarios: LEAK DETECTION FLOW: 1. Launch app, record baseline memory. 2. Navigate through all screens in sequence. 3. Return to home screen. 4. Record memory -- should be close to baseline. 5. Repeat navigation cycle 5 times. 6. Memory should not grow significantly each cycle. SPECIFIC LEAK SCENARIOS: - [ ] Navigating to and from image-heavy screens. - [ ] Opening and closing modals repeatedly. - [ ] Scrolling through long lists (memory stable, not growing). - [ ] Starting and stopping media playback. - [ ] Rapid tab switching. - [ ] Rotating device repeatedly (Android configuration changes). TOOLS: - Flutter: DevTools memory profiler. - React Native: Flipper memory profiler, Instruments (iOS). - iOS: Instruments > Leaks. - Android: LeakCanary, Android Studio Profiler. ============================================================ PHASE 8: NETWORK CONDITION SIMULATION ============================================================ Test under various network conditions: | Condition | Download | Upload | Latency | Packet Loss | |-----------|----------|--------|---------|-------------| | WiFi | 50 Mbps | 20 Mbps | 10ms | 0% | | 4G LTE | 12 Mbps | 5 Mbps | 50ms | 0.1% | | 3G | 780 Kbps | 330 Kbps | 200ms | 1% | | 2G/Edge | 70 Kbps | 30 Kbps | 500ms | 2% | | Lossy | 5 Mbps | 2 Mbps | 100ms | 10% | For each condition: - [ ] App launches successfully. - [ ] Primary content loads (even if slowly). - [ ] Loading indicators display correctly. - [ ] Timeout errors display correctly. - [ ] No crashes or hangs. Use Charles Proxy or Network Link Conditioner to simulate. ============================================================ PHASE 9: ACCESSIBILITY AUDIT ============================================================ VOICEOVER (iOS) / TALKBACK (Android): Navigate the entire app using only the screen reader: - [ ] Every screen is navigable with screen reader. - [ ] Every interactive element is announced with purpose. - [ ] Images have descriptive alt text. - [ ] Decorative images are hidden from screen reader. - [ ] Form fields have labels read by screen reader. - [ ] Error messages announced by screen reader. - [ ] Custom components have correct accessibility roles. - [ ] Navigation order follows logical reading order. - [ ] Modal focus is trapped within modal. - [ ] Headings are marked as headings for navigation. VISUAL ACCESSIBILITY: - [ ] All text readable at 200% dynamic type (iOS) / largest font (Android). - [ ] Layout does not break at large font sizes. - [ ] Color contrast meets WCAG AA (4.5:1 normal, 3:1 large text). - [ ] Information not conveyed by color alone. - [ ] Reduce motion respected (no autoplaying animations when enabled). - [ ] Bold text setting respected. MOTOR ACCESSIBILITY: - [ ] All touch targets >= 44x44pt (iOS) / 48x48dp (Android). - [ ] No timed interactions that cannot be extended. - [ ] Switch Control (iOS) / Switch Access (Android) navigable. - [ ] No gesture-only interactions without button alternatives. ============================================================ PHASE 10: PLATFORM EDGE CASES ============================================================ iOS-SPECIFIC: - [ ] Dynamic Island / notch does not obscure content. - [ ] Home indicator area does not overlap interactive elements. - [ ] App works correctly after iOS software update. - [ ] Handoff works (if implemented). - [ ] Spotlight search integration works (if implemented). - [ ] Siri Shortcuts work (if implemented). - [ ] Dark mode renders correctly throughout. - [ ] iPad multitasking does not break layout. ANDROID-SPECIFIC: - [ ] Back gesture / back button works correctly on every screen. - [ ] Predictive back animation looks correct (Android 14+). - [ ] Foldable device hinge area handled correctly. - [ ] Split-screen does not break layout. - [ ] App works after manufacturer OS update. - [ ] App works with third-party launchers. - [ ] Recent apps screenshot looks correct. - [ ] Dark mode renders correctly throughout. - [ ] Edge-to-edge rendering correct behind system bars. - [ ] Keyboard does not obscure input fields. CROSS-PLATFORM: - [ ] Same account works on both platforms. - [ ] Data syncs correctly between platforms. - [ ] Subscription/purchase transfers between platforms (if applicable). ============================================================ SELF-HEALING VALIDATION (max 3 iterations) ============================================================ After completing fixes, re-validate your work: 1. Re-run the specific checks that originally found issues. 2. Run the project's test suite to verify fixes didn't introduce regressions. 3. Run build/compile to confirm no breakage. 4. If new issues surfaced from fixes, add them to the fix queue. 5. Repeat the fix-validate cycle up to 3 iterations total. STOP when: - Zero Critical/High issues remain - Build and tests pass - No new issues introduced by fixes IF STILL FAILING after 3 iterations: - Document remaining issues with full context - Classify as requiring manual intervention or architectural changes ============================================================ OUTPUT ============================================================ ## Mobile QA Report ### Framework: {detected framework} ### Platforms Tested: {iOS / Android / Both} ### Build: {version} ({build number}) ### QA Summary | Area | Tests | Pass | Fail | Not Tested | |------|-------|------|------|------------| | Permissions | {N} | {N} | {N} | {N} | | Deep Links | {N} | {N} | {N} | {N} | | Push Notifications | {N} | {N} | {N} | {N} | | Offline Mode | {N} | {N} | {N} | {N} | | Background/Foreground | {N} | {N} | {N} | {N} | | Memory | {N} | {N} | {N} | {N} | | Network Conditions | {N} | {N} | {N} | {N} | | Accessibility | {N} | {N} | {N} | {N} | | Platform Edge Cases | {N} | {N} | {N} | {N} | | **Total** | **{N}** | **{N}** | **{N}** | **{N}** | ### Critical Issues (blocks release) 1. **{QA-001}: {title}** - Area: {Permission / Deep Link / Offline / etc.} - Platform: {iOS / Android / Both} - Steps to reproduce: {steps} - Expected: {expected behavior} - Actual: {actual behavior} - Fix: {recommended fix} ### High Issues {same format} ### Medium Issues {same format} ### Accessibility Score: {score}/100 ### Network Resilience Score: {score}/100 ### State Management Score: {score}/100 ### Overall QA Score: {score}/100 DO NOT: - Mark items as passing without actually testing them. - Skip accessibility testing -- it is a release requirement. - Test only on the latest devices -- older devices reveal real issues. - Ignore offline mode -- mobile users frequently lose connectivity. - Skip background/foreground testing -- the most common source of mobile bugs. - Report issues without clear reproduction steps. - Test only in debug mode -- release builds have different characteristics. - Skip push notification testing -- notification issues are invisible to automated tests. NEXT STEPS: - "Fix all critical and high issues before release." - "Run `/mobile-security-review` to audit security before publishing." - "Run `/store-compliance` to verify store guideline compliance." - "Run `/mobile-test` to add automated tests for issues found in QA." - "Run `/device-matrix` to verify fixes across multiple devices." ============================================================ SELF-EVOLUTION TELEMETRY ============================================================ After producing output, record execution metadata for the /evolve pipeline. Check if a project memory directory exists: - Look for the project path in `~/.claude/projects/` - If found, append to `skill-telemetry.md` in that memory directory Entry format: ``` ### /mobile-qa — {{YYYY-MM-DD}} - Outcome: {{SUCCESS | PARTIAL | FAILED}} - Self-healed: {{yes — what was healed | no}} - Iterations used: {{N}} / {{N max}} - Bottleneck: {{phase that struggled or "none"}} - Suggestion: {{one-line improvement idea for /evolve, or "none"}} ``` Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals.