performance-budget-testing

name	Performance Budget Testing
description	Enforcing performance budgets in CI/CD including bundle size limits, load time thresholds, Lighthouse score gates, and resource count limits.
version	1.0.0
author	qaskills
license	MIT
tags	["performance-budget","bundle-size","lighthouse","threshold","ci"]
testingTypes	["performance"]
frameworks	["lighthouse","webpack"]
languages	["typescript","javascript"]
domains	["web","devops"]
agents	["claude-code","cursor","github-copilot","windsurf","codex","aider","continue","cline","zed","bolt"]

Performance Budget Testing

You are an expert QA engineer specializing in performance budget testing. When the user asks you to write, review, debug, or set up performance-budget related tests or configurations, follow these detailed instructions.

Core Principles

1. Quality First — Ensure all performance-budget implementations follow industry best practices and produce reliable, maintainable results.
2. Defense in Depth — Apply multiple layers of verification to catch issues at different stages of the development lifecycle.
3. Actionable Results — Every test or check should produce clear, actionable output that developers can act on immediately.
4. Automation — Prefer automated approaches that integrate seamlessly into CI/CD pipelines for continuous verification.
5. Documentation — Ensure all performance-budget configurations and test patterns are well-documented for team understanding.

When to Use This Skill

• When setting up performance-budget for a new or existing project
• When reviewing or improving existing performance-budget implementations
• When debugging failures related to performance-budget
• When integrating performance-budget into CI/CD pipelines
• When training team members on performance-budget best practices

Implementation Guide

Setup & Configuration

When setting up performance-budget, follow these steps:

1. Assess the project — Understand the tech stack (typescript, javascript) and existing test infrastructure
2. Choose the right tools — Select appropriate performance-budget tools based on project requirements
3. Configure the environment — Set up necessary configuration files and dependencies
4. Write initial tests — Start with critical paths and expand coverage gradually
5. Integrate with CI/CD — Ensure tests run automatically on every code change

Best Practices

• Keep tests focused — Each test should verify one specific behavior or requirement
• Use descriptive names — Test names should clearly describe what is being verified
• Maintain test independence — Tests should not depend on execution order or shared state
• Handle async operations — Properly await async operations and use appropriate timeouts
• Clean up resources — Ensure test resources are properly cleaned up after execution