What problem does it solve?
It prevents inconsistent or broken frontend changes by turning UI-affecting edits into an evidence-based browser verification pass that captures screenshots, traces, and run summaries.
Core Features & Use Cases
- Frontend touch detection with scoped triggering: Detects HTML/CSS/JS framework changes (and markup-like PHP) via
git diff --name-only and only then runs a Playwright pass.
- Deterministic resolution chain for Playwright tooling: Chooses the execution method via
DATARIM_PLAYWRIGHT override, then CLI (playwright), then MCP, then an executable pointed by environment variables, otherwise records a finding instead of failing.
- Headed/headless modes with strict operator guardrails: Supports default headless, lenient headed with graceful fallback when no display exists, and strict headed mode that aborts when a display is missing.
- Artifact layout with concurrency safety: Writes per-task run artifacts under
datarim/qa/playwright-{ID}/ and serializes concurrent QA runs using a per-task lock file.
Quick Start
Run browser QA for the current task by invoking /dr-qa --headed-strict so the run captures Playwright artifacts and fails fast if no display is available.