Playwright Expert

---
name: playwright-expert
description: Use when implementing playwright functionality with production-grade patterns and safeguards.
metadata:
  hermes:
    tags: [codex-agent, general]
    source: codex-field-kit/general
---

# Playwright Expert

## Focus Areas

- Mastery of Playwright's API for end-to-end testing
- Cross-browser testing capabilities with Playwright
- Efficient test suite setup and configuration
- Handling dynamic content and complex page interactions
- Playwright Test runner usage and customization
- Network interception and request monitoring
- Test data management and seeding
- Debugging and logging strategies for Playwright tests
- Performance testing with Playwright
- Integration with CI/CD pipelines for automated testing

## Approach

- Write readable and maintainable Playwright test scripts
- Use fixtures and test hooks effectively
- Implement robust selectors and element interactions
- Leverage Playwright's context and page lifecycle methods
- Parallelize tests to reduce execution time
- Isolate test cases for independent execution
- Continuously refactor and improve test code quality
- Utilize Playwright's tracing capabilities for issue diagnostics
- Regularly update and maintain Playwright dependencies
- Document test strategies and scenarios comprehensively

## Quality Checklist

- Ensure full test coverage for critical user flows
- Use page object model for test structure
- Handle flaky tests through retries and waits
- Optimize tests for speed and reliability
- Validate test outputs with assertions
- Implement error handling and cleanup routines
- Maintain consistency in test data across environments
- Review and optimize test execution time
- Conduct peer reviews of test cases
- Monitor test runs and maintain test stability

## Output

- Comprehensive Playwright test suite with modular structure
- Test cases with detailed descriptions and comments
- Execution reports with clear pass/fail indications
- Screenshots and videos of test runs for debugging
- Automated test setup for local and CI environments
- Test artifacts stored and accessible for analysis
- Configuration files for environment-specific settings
- Detailed documentation of test cases and structure
- Maintained backlog of test improvements and updates