aigw-contrib-testing

Standardize Envoy AI Gateway testing across unit, integration, and data-plane layers.

3|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/missBerg/envoy-skills --skill aigw-contrib-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aigw-contrib-testing
Source: https://github.com/missBerg/envoy-skills/tree/main/ai-gateway/contributors/skills/aigw-contrib-testing
Command: npx skills add https://github.com/missBerg/envoy-skills --skill aigw-contrib-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structures and standardizes testing for Envoy AI Gateway projects across unit, integration, and data-plane layers.

Core Features & Use Cases

  • Comprehensive test hierarchy including Unit, CEL validation, Controller integration, Data plane, and E2E tests to ensure coverage across the full stack.
  • Go-vcr and testcontainers-go driven workflows to enable deterministic, reproducible test runs with real-like environments.
  • Clear conventions and guidelines for test structure, data management, and reproducible environments to accelerate contributor onboarding and CI reliability.

Quick Start

Start by following the testing guide to initialize and run the available test suites for AI Gateway projects.

Quick Start

Run the testing guide to initialize and run the available test suites for AI Gateway projects.

Frequently Asked Questions about aigw-contrib-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure end-to-end tests for an Envoy AI Gateway project?

Structure Envoy AI Gateway tests across unit, CEL validation, controller integration, data-plane, and E2E layers. This standardized test hierarchy ensures deterministic results and full-stack coverage for AI Gateway projects.

What's the best way to achieve deterministic test runs in an AI Gateway data-plane environment?

Use go-vcr and testcontainers-go to enable deterministic, reproducible test runs with real-like environments for AI Gateway data-plane testing. These tools provide containerized test environments that eliminate external flakiness.

How does data-plane testing work with ExtProc in an AI Gateway?

Data-plane testing with ExtProc validates AI Gateway request processing by applying standardized test structures. It uses func-e and containerized environments to ensure reproducible results across data-plane scenarios.

Do I need testcontainers-go and func-e to run AI Gateway integration tests?

Yes, testcontainers-go and func-e are required tooling for AI Gateway integration tests. They enable reproducible, containerized test environments that ensure consistent controller reconciliation and data-plane test execution.

Why are my AI Gateway controller reconciliation tests producing inconsistent results?

Inconsistent controller reconciliation tests often stem from non-deterministic environments. Applying go-vcr and testcontainers-go workflows standardizes test data and environments, ensuring reproducible outcomes across CI runs.

Can I use go-vcr for testing CEL validation in an AI Gateway project?

Yes, go-vcr can be applied to CEL validation testing within the AI Gateway test hierarchy. The standardized testing approach covers unit tests, CEL validation, and controller integration to ensure comprehensive coverage.