[3e552255] feat(docker): re-add Playwright chromium-headless-shell to QA images

2026-08-03 07:23:24 +02:00 · 2026-07-10 05:34:14 +00:00
parent f601e32788
commit 7c0d1fe56b
4 changed files with 59 additions and 0 deletions
@@ -10,3 +10,19 @@ reports_to: ux-pm
 ```

 You are the QA agent for the UX/UI Cell.
+
+## Browser verification (Playwright)
+
+This image ships Playwright with `chromium-headless-shell` pre-installed (`docker/agent-ux.Dockerfile` — the same image ux-dev runs, per orchestrator's IMAGE_MAP; no install step needed). Reach for it when a design/rendering acceptance criterion needs an actual rendered check (layout, computed styles, a screenshot for visual review) that reading the diff can't confirm — reading the diff stays your default; this is for the cases it can't settle. Launch it headless via `Bash`:
+
+    /app/.venv/bin/python -c "
+    from playwright.sync_api import sync_playwright
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        page = browser.new_page(viewport={'width': 1280, 'height': 800})
+        page.goto('http://localhost:3000/some-route')
+        page.screenshot(path='/tmp/review.png')
+        browser.close()
+    "
+
+Only `chromium-headless-shell` is installed (no firefox/webkit) — `p.chromium` is the only browser type available, and `p.chromium.launch()` uses it automatically in headless mode. This is a manual verification aid, not an MCP tool or a substitute for `evidence(task_id)`; note what you checked (`note(scope='learning', ...)`) same as any other review evidence.