uvs-qa

Target

$ARGUMENTS

Parse $ARGUMENTS:

• First positional token without -- prefix → app URL (defaults to http://localhost:3000 if not given).
• --tier quick|standard|exhaustive → tier (defaults to standard).
• --baseline <path> → path to a prior qa-state.md for health-score delta (defaults to uv-out/qa-state.md, the flat pointer to the latest run, if present).

Session output directory

Write QA artifacts under this directory (scoped to the current session). The <session-output-dir>/qa/<ts>/ paths below all resolve under it:

!"${CLAUDE_PROJECT_DIR:-.}"/.claude/hooks/uv-out-session.sh

Stable flat pointer maintained for /uvs-commit and /ship:

!"${CLAUDE_PROJECT_DIR:-.}"/.claude/hooks/uv-out-pointer.sh qa-state.md qa/state.md

Project context

!cat CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"

Detected test framework

!(test -f playwright.config.ts && echo "playwright") || (test -f playwright.config.js && echo "playwright") || (test -f vitest.config.ts && echo "vitest") || (test -f jest.config.js && echo "jest") || (grep -l '"jest"' package.json 2>/dev/null && echo "jest") || echo "none-detected"

Tier definitions

Tier	Viewports	Pages	Console capture	Fix bugs	Generate regression tests
quick	1 (desktop 1440×900)	Top-level entry + 1 deep link	Yes	No (report only)	No
standard	2 (desktop 1440×900, mobile 390×844)	Entry + every link in nav + 2 deep flows	Yes	Only critical severity	When framework detected
exhaustive	3 (desktop, tablet 1024×768, mobile)	Every reachable page from nav + 3 deep flows + edge-case inputs	Yes	All critical + high	Yes when framework detected

If $ARGUMENTS doesn't specify a tier, default to standard.

Orchestration procedure

Execute these steps in order.

Step 1 — Setup

• Confirm Playwright MCP is reachable (mcp__playwright__browser_* tools available). If not, stop and tell user to enable the Playwright MCP server.
• Verify the target URL is reachable: curl -sf <url> > /dev/null. If not, stop and ask user to start the dev server.
• Create output directory: mkdir -p <session-output-dir>/qa/<ISO-timestamp>/screenshots (the <session-output-dir> printed above).
• If framework detected, note its config path; you'll write regression tests against it later.