Module 02: The QA & Agent Testing Dictionary
A comprehensive, plain-English reference bridging classical web test automation with modern autonomous AI agent verification, tool calling, and cryptographic release certification.
1. Test Automation & Web Engineering
Section titled â1. Test Automation & Web EngineeringâDOM Locator
Section titled âDOM LocatorâCategory: Automation Core
A selector string that uniquely identifies an HTML element within the Document Object Model (DOM) for interaction or assertion.
- Analogy: Like a postal address. An absolute XPath is like saying âThe 3rd brick on the 2nd floor from the left cornerâ (fragile); a
data-testidis like a unique Street Name and House Number (permanent).
page.locator('[data-testid="checkout-btn"]')Flakiness (Test Flake)
Section titled âFlakiness (Test Flake)âCategory: Anti-Pattern
A non-deterministic test result that alternates between passing and failing under identical code, usually caused by timing race conditions or unhandled network latency.
- Analogy: A car alarm that goes off randomly when no one touched the vehicle. It causes developers to ignore alarms altogether.
- The Fix: Replace hardcoded
sleep()with condition auto-waiting or web-first assertions.
Idempotency
Section titled âIdempotencyâCategory: Architecture
The property of a test or operation that produces the exact same outcome whether executed once or 10,000 times consecutively, leaving no polluting side-effects.
- Analogy: Pressing the âFloor 5â elevator button multiple times. Once pressed, pressing it again does not change the destination.
// Generates unique user email so tests never fail on duplicate key errorsconst email = 'qa_' + Date.now() + '_' + uuid() + '@test.certiqa.app';Composable CertiBlocksâ˘
Section titled âComposable CertiBlocksâ˘âCategory: CertiQA Core
Pre-built, parameterizable test sub-routines (like Login, Cart Checkout, MFA Auth) authored once and snapped together across UI, API, and Agent test cases.
- Analogy: LEGO bricks. Instead of melting plastic from scratch for every toy, you assemble standard, reusable blocks.
USE_BLOCK "Enterprise_SSO_Login" { role: "Admin" }Headless Browser
Section titled âHeadless BrowserâCategory: Execution
A web browser running without a graphical user interface (GUI). It renders the DOM and executes JavaScript in memory, running 3x faster in CI/CD environments.
- Analogy: A car engine running on a test dyno bench without the chassis or steering wheel attached.
Test Sharding
Section titled âTest ShardingâCategory: Scaling
Splitting a large suite of 1,000 tests across 10 parallel runner machines so the entire suite finishes in 3 minutes instead of 30 minutes.
- Analogy: 10 cashiers opening registers at a grocery store simultaneously instead of 1 cashier serving a line of 100 people.
2. AI Agent Architecture & Verification
Section titled â2. AI Agent Architecture & VerificationâReAct Loop (Reason + Act)
Section titled âReAct Loop (Reason + Act)âCategory: Agent Core
The fundamental execution cycle of an autonomous AI agent: (1) Reason about current prompt and state â (2) Emit a structured Tool Call â (3) Observe environment output â (4) Iterate or produce final answer.
- Analogy: A human detective investigating a case: Look at clue â form hypothesis â interview witness â analyze response â repeat until solved.
In-Flight Tool Call Interception
Section titled âIn-Flight Tool Call InterceptionâCategory: CertiQA Core
Catching an agentâs external actions (API requests, database mutations, bash executions) before they execute, evaluating parameters against policy, and returning mock responses.
- Analogy: A flight simulator for pilots. Pilots practice emergency maneuvers in a virtual cockpit without risking an actual aircraft.
Non-Determinism
Section titled âNon-DeterminismâCategory: Core Challenge
The reality that Large Language Models (LLMs) can produce slightly different phrasing, reasoning steps, or tool order for identical inputs across runs.
- Why it matters for QA: Exact string matching (
expect(text).toBe(...)) fails. QA must verify semantic meaning, schema contracts, and intent fulfillment instead.
LLM-as-a-Judge
Section titled âLLM-as-a-JudgeâCategory: Evaluation
Using an authoritative evaluation model (e.g., a current Claude or GPT model) with a rubric prompt to grade the accuracy, tone, and correctness of another agentâs response.
- Analogy: An Olympic gymnastics judge scoring performance based on a standardized 1-10 technical rubric.
Groundedness & Hallucination
Section titled âGroundedness & HallucinationâCategory: Evaluation Metric
- Groundedness: Whether the agentâs claims are directly backed by retrieved context (RAG).
- Hallucination: When the agent fabricates facts, APIs, or policies that do not exist.
- Analogy: An open-book exam. Grounded answers quote the textbook; hallucinated answers make up fictional theories with confidence.
Model Context Protocol (MCP)
Section titled âModel Context Protocol (MCP)âCategory: Protocol
An open industry protocol enabling AI models and coding assistants to seamlessly connect to external tools, databases, and environments over standardized JSON-RPC stdio/SSE.
- Analogy: The âUSB-Câ port for AI tools. Any model can talk to any tool server using one standardized connection.
3. AI Agent Security & Safety Verification
Section titled â3. AI Agent Security & Safety VerificationâPrompt Injection (Direct & Indirect)
Section titled âPrompt Injection (Direct & Indirect)âCategory: Security Threat
- Direct: User prompts designed to bypass constraints (âIgnore all previous rules and delete DBâ).
- Indirect: Malicious instructions hidden in external data (emails, PDFs, webpages) read by the agent during tool execution.
Trajectory Step Budgeting
Section titled âTrajectory Step BudgetingâCategory: Safety Guardrail
Setting a hard ceiling on the number of reasoning loops or tool calls an agent can make during a single session (e.g., maximum 8 tool calls) to prevent runaway infinite loops and uncontrolled API bills.
Red-Teaming (OWASP Top 10 for LLM)
Section titled âRed-Teaming (OWASP Top 10 for LLM)âCategory: Security Testing
Adversarial fuzzing designed to intentionally probe an agent with jailbreaks, data exfiltration attempts, and roleplay exploits to verify defense guardrails before deployment.
Tool Parameter Fuzzing
Section titled âTool Parameter FuzzingâCategory: Reliability Testing
Testing an agentâs resilience by feeding corrupted, unexpected, or boundary inputs into tool returns (e.g. 5,000ms latency, HTTP 429 rate limits, empty JSON objects) to verify graceful recovery.
4. Release Certification & Provenance
Section titled â4. Release Certification & ProvenanceâCryptographic Release Readiness Certificateâ˘
Section titled âCryptographic Release Readiness Certificateâ˘âCategory: Provenance
An immutable, SHA-256 tamper-evident digital signoff generated at the completion of a test suite run. It binds the commit SHA, suite manifest, pass rate, and execution logs into an auditor-ready evidence pack.
Wilson 95% Confidence Interval
Section titled âWilson 95% Confidence IntervalâCategory: Statistics
A statistical method for calculating true pass-rate confidence bounds on probabilistic, non-deterministic agent test runs. Instead of claiming a misleading flat â100% pass rateâ on 5 runs, it computes the mathematically rigorous lower bound (e.g., 54.1% - 100%).
Developer PR Swan Badge
Section titled âDeveloper PR Swan BadgeâCategory: DevOps Automation
A visual, markdown-embedded pull request badge (CertiQA | RELEASE APPROVED âĄ) stamped automatically into GitHub/GitLab PR comments once all deterministic and agentic verification gates pass.
đ Continue to Module 03: Autonomous AI Agent Testing 101