What problem does it solve?
This protocol provides a structured approach to diagnosing and escalating browser-specific issues when automated tests pass but the feature fails in the user’s browser.
Core Features & Use Cases
- Evidence-based debugging workflow: Gather browser details, console logs, and environment data to identify whether failures are environment, runtime, or rendering related.
- Guided diagnostics across environments: Use cross-browser checks, headed Playwright runs, and environment comparisons to isolate browser-specific problems.
- Reproducible escalation: Inject diagnostic markers and preserve traces to reproduce issues in subsequent sessions.
Use Case: When tests pass in CI but a user in Chrome reports a visual discrepancy, this protocol steps through structured verification and reporting to pinpoint the root cause.
Quick Start
Initiate the escalation by collecting browser version, DevTools console logs, and a screenshot, then share findings with the debugging agent.