Locator Healer Agent

What problem does it solve?

When UI changes break automation tests by causing "element not found" or "element detached" errors, this Skill locates the failing selector, analyzes the current DOM, and generates a stable replacement to restore test reliability and reduce manual triage time.

Core Features & Use Cases

• Failure analysis: Parse test error logs to identify the exact failing locator and the associated Page Object location.
• DOM inspection & comparison: Inspect the live DOM, compare it with the original selector context, and detect changed attributes or structure.
• Locator generation & validation: Propose replacement locators in priority order (accessibility attributes, data-testid, id, semantic queries, css, xpath), validate uniqueness and correctness, update the Page Object, and re-run the test to confirm the fix.
• Use Case: After a frontend deployment that moves elements or renames attributes, run the Locator Healer Agent to automatically repair selectors in Playwright/Selenium Page Objects and recover failing test runs.

Quick Start

Use the Locator Healer Agent to analyze a failing web UI test, identify the broken selector, propose and validate a stable replacement, update the Page Object, and re-run the test to verify success.