visual-regression

# Visual Regression Before/after screenshot comparison guard。每次執行都抓 fresh before / after screenshots，使用 Playwright diff，分析後刪除 temporary snapshots 與 test results； 不維護 long-lived baselines。 ## Contract VR 的測試單位是 domain，不是 repo。頁面由 configured URL paths 定義；不可因「頁面不在 目前 repo」而 skip。合法 skip 僅限 config 缺漏、dependency declined、clean local tree、 smart-skip 判斷無 visual impact、fixture 未建立、已知 SSR hang、環境依賴缺失。 VR 在 quality chain 中回答：「既有頁面是否仍 visually intact？」它不取代 Local CI Mirror， 也不取代 feature behavior verification。 ## Reference Loading 依執行情境讀取： | Situation | Load | |---|---| | Any VR run | `visual-regression-principles.md`, `visual-regression-preflight-flow.md`, `visual-regression-config.md`, `workspace-config.yaml` | | Screenshot execution | `visual-regression-capture-flow.md`, `dependency-consent.md` | | Fixtures enabled | `api-contract-guard.md`, `visual-regression-fixture-flow.md`, `vr-artifact-location.md` | | Analysis or JIRA report | `visual-regression-analysis-reporting.md` | JIRA report、Slack summary，或任何 external write body 送出前，必須依 `workspace-config.yaml` 的 `language` 驗證語言。 ## Flow 1. 解析 domain 與 company config，套用 root defaults inheritance。 2. 檢查 visual regression 是否已設定；未設定則 stop，不 improvisation。 3. 執行 smart skip、dependency consent、Playwright/toolchain readiness。 4. 決定 SIT 或 Local comparison path；SIT 不可達時依 reference fallback。 5. 透過 `polaris-env.sh` 啟動 production-equivalent proxy 與 dev environment。 6. Fixtures active 時先跑 API contract guard。 7. Capture before screenshots，capt...