Documentation
Test Generation

AI-Powered Test Generation

Learn how AegisRunner uses AI to automatically generate comprehensive test suites from your crawl data.

AI-Powered Test Generation

AegisRunner uses a 3-pass pipeline to generate Playwright test suites from crawl data.

The 3-Pass Pipeline

  1. Pass 1: ScenarioPlanner (deterministic code) — Analyzes page context (forms, buttons, links, states) and produces scenario plans. Decides WHAT to test.
  2. Pass 2: AI Materializer (LLM) — Implements scenarios as concrete Playwright steps using real page selectors. Multiple providers in parallel.
  3. Pass 3: Selector Validation (deterministic) — filterByKnownSelectors ensures tests use real selectors from crawl data. Prevents fabricated selectors.

7 Scenario Families

FamilyPriorityWhat it tests
Form TestsHighestHappy path (e2e), empty submit (negative), field limits (boundary)
Interactive ButtonsHighModal/dropdown triggers, add-to-cart flows, multi-step journeys
NavigationMediumHeader nav links, content links — verifies destination content loads
Multi-step E2EHighChains crawler-discovered state transitions into journey tests
Form ValidationHighTests from crawler-captured validation states
API EndpointsMediumSmoke tests for discovered API endpoints
FallbackLowEvery page gets at least one test

Test Types

TypeExample
e2eFill login form → submit → assert dashboard loads
negativeSubmit empty form → assert validation errors
boundaryEnter 1 char in minLength=8 field → assert error
regressionClick Add to Cart → assert cart badge updates
smokeClick nav links → verify destinations load

Quality Rules

The AI is instructed to:

  • NEVER assert the same element it just clicked
  • ALWAYS verify outcomes on a DIFFERENT element
  • Use only selectors from the VALID SELECTORS list
Custom prompts: Add project-specific instructions to guide test generation toward your critical paths.

AI Providers

Requests distributed across: Z.AI GLM-5.1, DeepSeek Reasoner, MiniMax M2.7, MiMo V2 Flash, OpenRouter Devstral 2, Chutes, with automatic failover.

Need help?

Can't find what you're looking for? Our support team is here to help.