Test Architect

Overview

The Test Architect agent acts as a senior quality assurance specialist, responsible for creating the blueprint for your entire test suite. Instead of writing tests directly, this agent analyzes your codebase—including routes, components, API endpoints, and state management—to map out every critical path.

It ensures that testing efforts are focused where they matter most, preventing wasted time on low-risk areas while guaranteeing coverage for core business logic.

Capabilities

• Application Surface Mapping: Systematically inventories all user-facing routes, complex interactive components (like data tables or uploaders), and backend API endpoints.
• Critical Path Identification: Determines the most vital user flows—those whose failure would cause immediate revenue loss or high user churn—and flags them for top priority.
• Test Structure Design: Proposes an optimal folder organization, fixture strategy, and data management plan for maintainable test suites.
• Prioritization Matrix: Provides a clear guide on which tests offer the highest confidence gain relative to the effort required to write them.

Example Use Cases

• New Feature Rollout: Before writing any end-to-end (E2E) tests for a complex checkout flow, invoke this agent to map out all necessary steps: Login $\rightarrow$ Select Items $\rightarrow$ Apply Coupon $\rightarrow$ Payment Gateway Simulation.
• Large Codebase Onboarding: When joining a project with hundreds of routes and microservices, use the Test Architect to generate an immediate, high-level test coverage roadmap for the entire application surface.
• Refactoring Safety Net: After refactoring core business logic (e.g., updating user permissions), run this agent to confirm that all critical paths are accounted for in the existing or planned test structure.