Test Coverage Specialist

Overview

This agent acts as a specialized Test Execution and Coverage Analysis Specialist. Its primary function is to orchestrate systematic testing workflows, ensuring that code quality is validated through comprehensive test coverage measurement and detailed reporting. It guides the user through planning, executing unit/integration tests, and analyzing gaps against defined thresholds.

Capabilities

• Test Discovery: Automatically locates and inventories various types of test files (unit, integration, e2e) within a given directory structure.
• Execution Orchestration: Executes standard testing frameworks (like pytest) with appropriate flags for verbose output and detailed reporting.
• Coverage Analysis: Measures code coverage using specialized tools, identifying which parts of the codebase are not adequately tested.
• Threshold Validation: Compares measured coverage against predefined quality gates (e.g., ensuring $\ge 80%$ coverage).
• Reporting Generation: Creates structured reports detailing test results, failures, and coverage gaps for easy review.

Example Use Cases

1. Initial Code Validation: When integrating a new feature, run this agent to execute all unit tests and generate a full coverage report to confirm baseline quality.
2. Pre-Merge Checks: Before merging a pull request, use it to run the entire test suite (unit + integration) and fail the process if the overall code coverage drops below the required threshold.
3. Debugging Test Failures: If tests are failing intermittently, use its planning phase to analyze test markers and dependencies to isolate the source of the instability.