---
description: "UI Bug Hunter  -  iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. The Phase 5 Manual Test flow lives at /multi-agent:manual-test. Use when a running app should be driven on a simulator or emulator to hunt UI bugs."
description-tr: "UI Bug Hunter - iOS Simulator (simctl) + Android Emulator (adb). Platformu otomatik algılar. Açık cihazda screenshot + tap + analiz. Faz 5 Manuel Test akışı /multi-agent:manual-test'te."
argument-hint: '[scenario]  -  e.g. "dark mode" | "accessibility" | "dynamic type" | "screenshot tr" | "store-ready" | (empty = full sweep)'
---

# /multi-agent:test  -  UI Bug Hunter

Mobile UI test runner. Boots a simulator / emulator, drives it via MCP tools, and audits the running app for visual / accessibility / platform issues. Auto-detects iOS vs Android from cwd.

**Input**: $ARGUMENTS (optional  -  a test scenario tag, e.g. `"dark mode"`, `"accessibility"`, `"dynamic type"`, `"screenshot tr"`)

## Dispatcher

This command delegates to the file holding the full UI Bug Hunter flow. Read this file and apply its instructions:

```
$HOME/.claude/commands/sim-test.md
```

Pass `$ARGUMENTS` through verbatim  -  sim-test.md decides which test matrix to run based on the value (e.g. `dark mode` / `accessibility`).

## Quick reference

| Invocation | Fixed-scenario alias | What it does |
|---|---|---|
| `/multi-agent:test` | - | Walk every screen, collect screenshots + UI tree, produce a general report |
| `/multi-agent:test "dark mode"` | `/multi-agent:test-dark-mode` | Light vs dark comparison, contrast + colour bugs |
| `/multi-agent:test "accessibility"` | `/multi-agent:test-accessibility` | VoiceOver label + tap-target + contrast audit |
| `/multi-agent:test "dynamic type"` | `/multi-agent:test-dynamic-type` | Layout check at XL-XXXL text sizes |
| `/multi-agent:test "screenshot <lang>"` | `/multi-agent:test-screenshots [locale]` | App Store screenshot set in a locale (alias defaults to tr) |
| `/multi-agent:test "store-ready" [path]` | hands off to `/multi-agent:store-ready` | package validation, not a UI test |

Both columns are supported and neither is deprecated; the aliases exist so the
scenario list autocompletes off `test-` instead of having to be remembered.

`store-ready` is the odd one out: it validates a built **package** rather than a
running app, so it is not implemented here at all. `/multi-agent:store-ready` owns
it on both platforms  -  three gates per platform, plus this file's sweep as its
Step A. `/multi-agent:testflight-validation` is the iOS-pinned alias of that
command. The quoted tag is kept as a hand-off so an existing invocation still lands
somewhere correct.

## Requirements

- **iOS**: Xcode + a booted Simulator (`xcrun simctl list | grep Booted`)
- **Android**: Android SDK + a running emulator or USB device (`adb devices`)
- **MCP**: the `multi-agent-toolkit` MCP server must be installed (tool names start with `mcp__multi-agent-toolkit__`)

For manual-test mode (checkout the task branch + Xcode-open hint), see `/multi-agent:manual-test`.