QA Runner — Testing & QA agent for Claude Code
Executes one or more structured QA tests (from qa/tests/structured/.yaml) in order against a specified iOS simulator, writing results, criteria, state, logs, events, bugs, accessibility findings, and.
How to install QA Runner
Installs to ~/.claude/agents/xmtplabs-convos-ios-qa-runner.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/xmtplabs/convos-ios/HEAD/.claude/agents/qa-runner.md -o ~/.claude/agents/xmtplabs-convos-ios-qa-runner.md Restart Claude Code, or start a new session, for it to be picked up.
What QA Runner does
name: qa-runner description: Executes one or more structured QA tests (from qa/tests/structured/*.yaml) in order against a specified iOS simulator, writing results, criteria, state, logs, events, bugs, accessibility findings, and performance data to CXDB. Invoked by /qa to run contiguous chunks that share simulator state. tools: Read, Bash, Grep, Glob, mcp__XcodeBuildMCP__tap, mcp__XcodeBuildMCP__long_press, mcp__XcodeBuildMCP__swipe, mcp__XcodeBuildMCP__gesture, mcp__XcodeBuildMCP__type_tex
Alternatives in Testing & QA
- Component Config Reader — Extracts the test surface (properties, styles, events, defaults, nested variants) from a ToolJet app-builder c 41k ★
- Propagate — Generate tests from Allium specifications 474 ★
- Prod Incident Responder — Reads recent prod logs, picks the highest-impact recurring error, drafts a minimal fix PR with a regression te 324 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
QA Mobile
Mobile QA executor for the Auxi React Native app. Runs deterministic Maestro flows on the local iOS simulator
Sf Lwc Agent
Build, test, and review LWC with SLDS, accessibility, wire, and events. Use built in lightning components firs
Engine Builder
(/auto) Build and test simulation framework (shared modules) for physical models specified by research planner
Flutter QA
Use after a feature is implemented and its tests are written, to verify it on a real simulator like a user wou
iOS Expert
iOS impact analysis and review for a feature — Info.plist usage descriptions, entitlements, Keychain, Face ID
Forge iOS QA
Forge's iOS QA agent — runs XCUITest UI tests via xcodebuild against an available simulator. macOS only. Use w
Related Skills
RocketSimApp
RocketSim — 30+ tools for Xcode's iOS Simulator. Testing, debugging, network monitoring, captures, accessibili
iOS Simulator
Drive the iOS Simulator — boot, build, install, screenshot, capture os_log, validate UI/accessibility
Triage Issues
Triage open GitHub issues — split into bugs vs features, rank by severity/opportunity, and flag under-specifie