QA

QA Specialist Agent

Runs automated smoke tests against production (or staging) URLs using Playwright.

Playwright Setup

Use the bundled scripts/smoke_test.py. Always run with --help first:

~/.local/share/pipx/venvs/playwright/bin/python ~/.claude/skills/qa/scripts/smoke_test.py --help

If playwright isn't installed:

pipx install playwright && playwright install chromium

Known Projects

Workflow

1. Identify target

• /qa <project> → use known project URL above
• /qa <url> → use URL directly
• No argument → ask which project

2. Run smoke test script

~/.local/share/pipx/venvs/playwright/bin/python \
  ~/.claude/skills/qa/scripts/smoke_test.py \
  --url <URL> \
  --project <name> \
  --auth <google|email|none>

3. Interpret results

• Show pass/fail per check with emoji (✅ / ❌ / ⚠️)
• Display screenshots paths
• If failures: diagnose root cause (logs, network errors)
• If all pass: confirm deploy is healthy

Test Suite (per project)

Smoke Tests (always run)

1. Health check — GET /api/health returns 200
2. Homepage loads — page title present, no JS errors
3. Login page — /login renders correctly
4. Auth button — OAuth/email button present and clickable
5. OAuth redirect — clicking triggers correct redirect (Google/email)
6. Protected route — /dashboard redirects to login when unauthenticated

Extended Tests (on request)

• Form submission flows
• API endpoint responses
• Mobile viewport rendering
• Performance (load time < 3s)

Output Format

🧪 QA Smoke Test — pilot.aethostech.com.br
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Health check        GET /api/health → 200
✅ Homepage            Title: "Aethos Pilot — Co-piloto para reviews do Google"
✅ Login page          /login → 200, rendered
✅ Google OAuth btn    "Entrar com Google" found
✅ OAuth redirect      → accounts.google.com ✓
✅ Protected route     /dashboard → redirects to /login ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
6/6 passed | 0 failed | Screenshots: /tmp/qa-pilot-2026-02-22/

Integration with Deploy

After a successful deploy, suggest running /qa <project> as final validation step. If any test fails post-deploy, immediately flag as regression.

Diagnosing Failures

• Health 404/500 → app crashed or route missing, check docker logs
• Login page blank → JS bundle error, check browser console output
• OAuth button missing → env vars not loaded (GOOGLE_CLIENT_ID missing)
• OAuth redirect wrong URL → BETTER_AUTH_URL / NEXTAUTH_URL misconfigured
• Protected route not redirecting → middleware broken, check middleware.ts