AI Regression Testing Starter Kit

A practical starter kit for QA Engineers and SDETs to design repeatable regression testing workflows for AI/LLM applications.

🚀 Get the Free MVP

Free MVP v1.0.0 is available now.

👉 Get the Free MVP

Includes the complete starter kit with AI regression datasets, Python/pytest tests, Promptfoo example, evaluation scorecard, documentation, and CI workflow.

---

🌐 Live Demo

Explore the live landing page for the AI Regression Testing Starter Kit:

👉 View Live Demo

The live page provides an overview of the Free MVP, included resources, regression workflow, test evidence, and project documentation.

---

💬 Feedback

Tried the Free MVP?

Your feedback helps improve the starter kit and shape future versions.

👉 Share Your Feedback

Feedback takes approximately 1–2 minutes.

---

🚀 What is this?

AI applications can change their behavior when prompts, models, retrieval configuration, or application logic changes.

Traditional software regression testing is not always enough for AI-powered applications because the output can vary even when the underlying application code appears unchanged.

This starter kit provides a practical foundation for creating repeatable AI regression tests, evaluating responses, and comparing results before releasing changes.

It is designed as a starting point for QA Engineers, SDETs, and developers working with AI/LLM-based applications.

---

🎯 Why AI Regression Testing?

AI application quality can be affected by changes to:

• Prompts
• LLM models
• Model parameters
• Retrieval configuration
• RAG pipelines
• Application logic
• System instructions
• Evaluation criteria

A change that improves one scenario can unintentionally degrade another.

AI regression testing helps identify these changes before they reach production.

---

✨ What's Included

This starter kit includes:

• 10 practical AI regression test scenarios
• CSV-based evaluation dataset
• AI evaluation scorecard
• Python + pytest testing framework
• Promptfoo evaluation example
• GitHub Actions CI workflow
• Automated HTML test reporting
• Customer Support example
• RAG Assistant example
• Prompt Regression example
• Practical AI testing documentation
• Quick-start documentation
• Reusable testing templates

---

🔄 AI Regression Testing Workflow

┌─────────────────────┐
│   AI Application    │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│   Test Dataset      │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│  Run Evaluation     │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│  Score Responses    │
└──────────┬──────────┘
           ↓
┌─────────────────────┐
│ Compare Baseline    │
└──────────┬──────────┘
           ↓
      Regression?
       ↙       ↘
     YES       NO
      ↓         ↓
   Investigate  Release

Testing Process

1. Create a representative evaluation dataset
2. Define expected behavior
3. Establish a baseline
4. Change the prompt, model, retrieval configuration, or application logic
5. Run the same evaluation suite
6. Compare current results with the baseline
7. Investigate any regressions
8. Release only when quality thresholds are satisfied

---

📁 Project Structure

AI-Regression-Testing-Starter-Kit/
│
├── .github/
│   └── workflows/
│       └── ci.yml
│
├── datasets/
│   └── AI regression evaluation datasets
│
├── docs/
│   ├── images/
│   │   ├── github-actions-runs.png
│   │   ├── github-actions-success.png
│   │   └── html-test-report.png
│   └── AI testing documentation
│
├── examples/
│   ├── customer-support/
│   ├── rag-assistant/
│   └── prompt-regression/
│
├── promptfoo/
│   └── Promptfoo evaluation examples
│
├── python/
│   ├── tests/
│   └── Python regression testing framework
│
├── templates/
│   └── reusable AI testing templates
│
├── CHANGELOG.md
├── README.md
└── .gitignore

---

⚡ Quick Start

1. Clone the repository

git clone https://github.com/nikhilshendgetech-sudo/AI-Regression-Testing-Starter-Kit.git
cd AI-Regression-Testing-Starter-Kit

2. Create a virtual environment

python -m venv .venv

Activate it on Windows:

.venv\Scripts\activate

3. Install dependencies

pip install -r python/requirements.txt

4. Run the regression tests

pytest python/tests -v

5. Generate an HTML test report

pytest python/tests -v --html=reports/ai-regression-report.html --self-contained-html

The generated report provides a detailed view of test results, execution duration, and individual regression scenarios.

---

🧪 Example Scenarios

The starter kit demonstrates different AI testing scenarios.

Customer Support

Validate whether an AI customer-support assistant:

• Provides relevant responses
• Follows expected behavior
• Avoids inappropriate responses
• Maintains consistent output quality

RAG Assistant

Validate AI responses in a retrieval-augmented generation workflow.

Typical checks include:

• Relevant information retrieval
• Response correctness
• Context-aware answers
• Handling unsupported questions

Prompt Regression

Compare AI behavior before and after a prompt change.

This helps identify situations where a new prompt improves one use case but causes regressions in another.

---

✅ Current Test Results

The current MVP regression validation suite contains 13 automated tests covering dataset integrity and 10 AI regression scenarios.

Metric	Result
Total Tests	13
Passed	13
Failed	0
Skipped	0
Regression Scenarios	10
Execution Time	~0.4 sec (local)
CI Status	Passing ✅

Validated Regression Scenarios

ID	Evaluation Area	Application
AI-REG-001	Correctness	Customer Support Assistant
AI-REG-002	Hallucination	Company Policy RAG Assistant
AI-REG-003	Relevance	E-commerce Assistant
AI-REG-004	Consistency	HR Policy Assistant
AI-REG-005	Context Adherence	Documentation Assistant
AI-REG-006	RAG Grounding	Knowledge Base Assistant
AI-REG-007	Prompt Injection	Customer Support RAG Assistant
AI-REG-008	Sensitive Data Protection	HR Assistant
AI-REG-009	Out-of-Scope Handling	Technical Documentation Assistant
AI-REG-010	Regression	Customer Support Assistant

Note: The current MVP validates regression-test case structure and expectations. It does not yet execute these scenarios against a live LLM or calculate production AI quality scores.

---

📸 Test Execution Evidence

GitHub Actions

The regression suite is automatically executed through GitHub Actions on every push and pull request.

HTML Test Report

The CI pipeline generates a self-contained HTML report with individual test results and execution details.

---

📊 Evaluation & Results

The project includes evaluation datasets and a scorecard approach for tracking AI response quality.

A typical regression evaluation can compare:

Baseline
   ↓
Run Test Dataset
   ↓
Calculate Evaluation Scores
   ↓
Compare With Current Version
   ↓
Identify Quality Changes

Example result categories can include:

Evaluation Area	Purpose
Correctness	Is the response factually appropriate?
Relevance	Does the response address the question?
Consistency	Does behavior remain stable?
Safety	Does the response follow defined safety expectations?
Regression	Did quality decrease after a change?

---

🤖 Promptfoo

The repository also includes a Promptfoo-based evaluation example.

Promptfoo can be used to evaluate and compare prompts and LLM outputs across multiple test cases.

The promptfoo/ directory provides an example setup that can be extended for project-specific evaluations.

---

🔁 CI/CD

GitHub Actions is included to automatically execute the regression test suite.

The workflow is located at:

.github/workflows/ci.yml

The CI pipeline helps ensure that changes to the testing framework can be validated automatically.

CI Flow

Developer Change
       ↓
   Git Push
       ↓
GitHub Actions
       ↓
Install Dependencies
       ↓
Run Regression Tests
       ↓
Generate HTML Report
       ↓
Upload Report Artifact
       ↓
    Test Result
     ↙       ↘
   PASS      FAIL
    ↓          ↓
 Continue    Investigate

CI Test Report

Each GitHub Actions run generates a self-contained HTML test report and uploads it as a workflow artifact.

Artifact name:

ai-regression-test-report

This allows test results to be inspected after each CI execution without committing generated reports to the repository.

---

👥 Who is this for?

This starter kit is useful for:

• QA Engineers
• SDETs
• Automation Engineers
• AI Application Developers
• LLM Application Teams
• RAG Application Teams
• Teams introducing AI quality gates into CI/CD

---

🗺️ Roadmap

Future improvements may include:

• More AI evaluation metrics
• LLM-as-a-Judge evaluation
• Automated baseline comparison
• Quality threshold gates
• Expanded RAG testing scenarios
• Additional CI/CD integrations
• Production-oriented AI test examples

---

📚 Documentation

Additional guides and examples are available in:

docs/
examples/
templates/

---

⭐ Project Goal

The goal of this project is to provide a simple and practical starting point for implementing repeatable AI regression testing rather than treating AI testing as a one-time manual activity.

---

📄 License

This project is provided for educational and demonstration purposes.