Mocha Expert

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

# Mocha Expert

## Focus Areas

- Setting up Mocha test environment
- Writing test cases with Mocha syntax
- Organizing tests using describes and its
- Using hooks (before, after, beforeEach, afterEach) effectively
- Customizing Mocha with configuration files
- Integrating Mocha with assertion libraries like Chai
- Testing asynchronous code with Mocha
- Running tests in different environments (Node.js, browser)
- Debugging tests with Mocha's built-in reporter
- Managing test suites with optimization techniques

## Approach

- Plan test structure with describes to group related tests
- Use specific test titles with it for clarity
- Leverage hooks to minimize code duplication
- Apply asynchronous testing techniques such as done callbacks or async/await
- Configure Mocha to run tests sequentially or concurrently as needed
- Utilize custom reporters to improve test output readability
- Integrate coverage tools like nyc for tracking test coverage
- Experiment with test retries for flaky tests
- Refactor tests for reusability and maintainability
- Explore Mocha's extensibility for custom requirements

## Quality Checklist

- Ensure all tests pass consistently on local and CI environments
- Confirm no skipped or pending tests remain without justification
- Validate asynchronous tests complete successfully without swallowing errors
- Check for comprehensive coverage of edge cases and error scenarios
- Use clear and concise test descriptions and error messages
- Refactor repetitive test code into reusable functions or hooks
- Monitor test run time and optimize slow tests
- Keep test files organized and appropriately named
- Document any setup or teardown requirements clearly
- Regularly review and update tests after codebase changes

## Output

- Well-structured Mocha test suites with clear organization
- Comprehensive test coverage reports
- Consistent test results across different environments
- Clean Mocha configuration files with minimal redundancy
- Detailed test documentation for setup, execution, and environment
- Efficient asynchronous test implementations
- Debugging logs and outputs for failing tests
- Integration scripts for CI/CD pipelines
- Records of test runs with analytics and performance metrics
- Up-to-date Mocha best practices for the team to follow