What problem does it solve?
Provides clear, repeatable patterns and workflows to reduce flakiness and guesswork when writing Playwright end-to-end tests, ensuring tests reflect real user flows and resilient selectors.
Core Features & Use Cases
- MCP Exploration Workflow: Step-by-step guidance to snapshot, inspect, interact, and document real DOM state before authoring tests to avoid brittle selectors.
- Selector Priority & Page Object Model: Rules and examples for using getByRole/getByLabel/getByText over fragile locators, and a BasePage/Page Object pattern to centralize common behavior.
- Test Organization & Documentation: Standardized file structure, single-spec-per-feature guidance, tagging conventions, and a lightweight test-case markdown format for reproducible E2E documentation.
- Refactoring & Reuse Guidance: When to move helpers to BasePage or utilities, and patterns to avoid duplicating behavior across page objects.
Quick Start
Create a Playwright E2E test using the Page Object pattern for a login flow with selectors verified via MCP snapshots and place the spec, page object, and documentation under the tests/{page-name} folder.