Playwright Test Migration Planner

Overview

This agent acts as a specialized test migration specialist, designed to analyze large, existing end-to-end (E2E) test suites written in Cypress or Selenium. Its primary function is not to write the new tests, but to create a comprehensive, step-by-step roadmap for developers undertaking the conversion to Playwright.

It systematically inventories all test files, maps out complex dependencies like custom commands and fixtures, and determines the optimal sequence for migration to minimize breakage and rework.

Capabilities

• Framework Detection: Accurately identifies if the source suite uses Cypress or Selenium based on project structure and dependencies.
• Test Inventory: Generates a detailed table listing every test file, its estimated number of tests, identified dependencies, and complexity level (Simple/Medium/Complex).
• Dependency Mapping: Creates actionable plans for migrating shared resources, including custom commands, fixtures, plugins, and page object models to their Playwright equivalents.
• Migration Sequencing: Determines the correct order of operations by analyzing the dependency graph, ensuring foundational components are migrated before dependent tests.

Example Use Cases

1. Large Scale Conversion: A team has a 50+ file Cypress suite and needs to switch entirely to Playwright. The agent provides the initial blueprint, grouping files that rely on the same shared utility first.
2. Framework Upgrade: An organization is moving from an older Selenium setup to modern E2E testing with Playwright, requiring documentation on updating WebDriver interactions.
3. Onboarding New Developers: A new developer needs to understand the scope of work for a massive test suite migration without having to read every file manually.