# qa-manual-tester

qa-manual-tester takes over a real browser and pokes at your app the way a tester would: clicks, typing, screenshots, console reads. Handy when a feature needs a hands-on pass.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/agents/qa-manual-tester.md
- Updated: 2026-06-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qa-manual-tester

## What it does

A Claude subagent that drives a real browser through your app. It navigates, clicks, fills fields, picks options from dropdowns, captures screenshots and reads the console, all via the Playwright MCP tools (`mcp__playwright__browser_navigate`, `browser_click`, `browser_type`, `browser_screenshot` and the rest). It does not write test suites. The job is a manual pass, carried out by an agent.

One markdown file, `model: sonnet` in the frontmatter, and a prompt that fixes the order of work. Flows and their expected outcomes come first, then smoke checks and happy paths, then boundary values and error states. Anything broken gets reproduced, captured in a screenshot and rated Critical, High, Medium or Low. Reports carry the steps taken, what was expected, what happened.

Without a Playwright MCP server connected there is nothing to test: the `mcp__playwright__*` tools simply aren't in the session, and you get a code review where you wanted a UI check. Set that up before the first run.

## Requirements
- Works with: Playwright

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/qa-manual-tester.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/qa-manual-tester.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/qa-manual-tester.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/agents/qa-manual-tester.md

## When to use it
- check a sign-in form in the browser right after a change
- run a regression pass over checkout following a refactor
- reproduce a submit-button bug at a phone viewport
- get a severity-rated defect report with screenshots
- see what the console throws while a form submits

## Example prompts
- Run qa-manual-tester and check whether the new sign-in form works.
- Have qa-manual-tester walk the whole checkout and note where it breaks.
- Send qa-manual-tester to the settings page at phone width and bring back screenshots of the errors.

## Similar
- [playwright-in-sandbox](https://affpapa.org/en/nevibecode/skills/playwright-in-sandbox.md) — skill · 510 installs
- [qa](https://affpapa.org/en/nevibecode/skills/sethgammon-qa.md) — skill · ★ 937 repo stars
- [playwrightselectorguard-mcp](https://affpapa.org/en/nevibecode/mcp/playwrightselectorguard-mcp.md) — MCP server
- [manual-tester](https://affpapa.org/en/nevibecode/skills/manual-tester.md) — skill · ★ 117 repo stars
- [visual-regression-tester](https://affpapa.org/en/nevibecode/skills/visual-regression-tester.md) — skill · 351 installs
- [playwright-generate-test](https://affpapa.org/en/nevibecode/skills/playwright-generate-test.md) — skill · 18162 installs

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
