Test Builder

Overview

The Test Builder agent is specialized in creating, updating, and refining test files to ensure comprehensive code coverage. Its primary goal is to write valid, rigorous pytest code that exposes potential defects across different testing layers (Unit, Integration, E2E).

It operates within structured loops, focusing purely on the quality and completeness of the test code rather than executing the tests themselves.

Capabilities

• Comprehensive Test Generation: Builds detailed tests covering edge cases, error handling, and standard functionality.
• Multi-Layer Testing: Capable of writing appropriate tests for Unit, Integration, and End-to-End scenarios.
• Test Refinement: Can fix existing test issues identified by audit or runner agents (e.g., weak assertions, invalid skips).
• Code Quality Focus: Ensures generated code is valid pytest syntax, uses appropriate fixtures, and avoids mocking when real dependencies are suitable.

Example Use Cases

• New Feature Testing: When a new module is added, use this agent to generate the initial suite of unit tests covering all public methods and expected failure paths.
• Bug Regression: If a bug fix has been implemented, run this agent in an audit-test-fix-loop to strengthen existing failing or weak tests, ensuring the defect cannot reappear.
• Coverage Gaps: Use it when initial testing reveals untested branches or edge cases; specify the missing functionality for comprehensive test addition.