Debug Test

When to use

• When a Playwright test fails after generate-tests
• When running as part of run-testing-session pipeline (after generate-tests FAIL)
• When a previously passing test starts failing after a UI change

Inputs

• Failing test file path
• Full error output from the test run
• docs/playwright-spec-testing/exploration/[SCENARIO_SLUG].md — original selectors
• docs/playwright-spec-testing/test-plan.md — scenario context
• docs/playwright-spec-testing/project-context.md — for baseURL

What it does

Diagnose the failure and apply a minimal fix. Debug in this order: