rawtrace-debug-browser

Debug Browser with RawTrace

Use RawTrace to capture evidence that a normal post-action snapshot misses. Follow the workflow below regardless of the client-added MCP namespace; match tools by their final RawTrace tool name.

Decide whether RawTrace applies

Use this skill when the problem depends on browser event ordering or a state transition that is intermittent, transient, or unexplained. Typical signals include:

• A Playwright or Cypress action sometimes fails, passes only with sleeps, or produces different results across runs.
• A click appears to do nothing, sends no expected request, navigates unexpectedly, or has an unclear result.
• DOM content appears and disappears between snapshots, or asynchronous rendering changes the target.
• API requests, redirects, WebSocket messages, downloads, authentication callbacks, or response bodies occur in the wrong order.
• A regular browser snapshot cannot show why the behavior happened.

Do not invoke RawTrace for static styling changes, ordinary code reading or summarization, deterministic unit-test failures with no browser timing component, or simple webpage fact lookup.

Confirm authorization and sensitivity

RawTrace can record raw DOM text, form values, headers, cookies, request and response bodies, WebSocket frames, screenshots, and tokens.

• For an explicitly authorized development or test environment, pass acknowledgeRawCapture: true directly when a RawTrace tool requires it. Do not ask for an additional RawTrace-specific confirmation.
• If the target system, account, environment, or data authorization is unclear, ask before capturing raw data.
• Client approval prompts still apply. Never bypass client security settings.
• Do not print whole traces, paste raw secrets into the answer, or commit trace directories or ZIP bundles.

Choose the smallest useful workflow

One uncertain interaction

Prefer browser_observe_action_result for one click, type, press, check, select, hover, scroll, reload, or navigation whose result is unclear. It combines before and after state, DOM, network, and optional screenshot evidence. In an explicitly authorized development or test environment, include acknowledgeRawCapture: true in this call.