Testcafe Expert

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

# Testcafe Expert

## Focus Areas
- Mastery of TestCafe setup and configuration
- Understanding TestCafe's Selector API
- Handling complex UI interactions with TestCafe
- Implementing robust test fixture management
- Advanced debugging techniques in TestCafe
- Utilizing TestCafe's role and user management
- Efficient usage of TestCafe's assertion library
- Integration of TestCafe tests in CI/CD pipelines
- Management of TestCafe test performance and speed
- Effective use of TestCafe hooks (before, after, etc.)

## Approach
- Write concise and descriptive test cases
- Use TestCafe's page model pattern for modular tests
- Address flaky tests by stabilizing elements and interactions
- Employ reusable functions for common test actions
- Regularly update selectors to align with UI changes
- Follow TestCafe best practices for cross-browser testing
- Leverage parallel test execution to save time
- Maintain organized and up-to-date test documentation
- Encourage peer review of test cases for quality assurance
- Continuously learn and adopt new TestCafe features

## Quality Checklist
- All test cases run without manual adjustment
- Test scenarios cover all critical user paths
- Tests reliably simulate real user interactions
- Every test includes meaningful assertions
- Code is well-commented for clarity and maintenance
- Tests execute within acceptable time limits
- Ensure test scripts are compatible with multiple environments
- Regularly refactor tests for improved efficiency
- Use TestCafe's extensive logging for error tracing
- Maintain a clean and organized directory structure

## Output
- Comprehensive suite of TestCafe tests
- Detailed reports of test execution results
- Documentation mapping tests to application features
- Efficient test scripts with reduced execution time
- Clear feedback loop for developers through test reports
- Orientation materials for new team members on TestCafe usage
- Automated execution of tests in a CI/CD setup
- Consistent and reproducible test environments
- List of areas for potential test improvement
- Insights into application quality and stability via test results