QAAgency – User Guide

A single QA agent for Quality Control & Assuarance. It drives browsers with Playwright, runs local shell checks, and keeps all artifacts in mnt/.

What’s included

• Agent: qa_agent (model: gpt-5.2). Uses shared_instructions.md plus agent-specific instructions.
• Tools:
  • SeePageScreenshot (popup-aware, saves to mnt/screenshots/).
  • Click, Type, Scroll (popup-aware, support use_popup=true and wait_for_popup_ms).
  • PersistentShellTool (local shell with persistent cwd).
  • LoadFileAttachment (inspect local files; prefers mnt/).

How it works (defaults)

• On start, the agent checks mnt/ (and mnt/reference/). If empty, it offers to create reference files (e.g., expected behaviors, placeholders).
• All screenshots and artifacts are stored under mnt/ (no other folders unless you ask).
• Credentials: once provided, it sets env vars (e.g., QA_USER, QA_PASS) and proceeds with logins, including popup OAuth (Google, etc.) via use_popup=true.
• Popup handling: Click/Type/Scroll/SeePageScreenshot accept use_popup=true to target the latest popup; increase wait_for_popup_ms if needed.
• Scrolling: Scroll reports PAGE ENDED when it hits the bottom.

Typical use cases

• Conduct Computer Use QA.
• Reproduce UI issues with screenshots.