performance-budget-guard

What problem does it solve?

Reviews and enforces performance budgets on routes, dependencies, heavy computations, DB queries on hot paths, and UI changes to prevent regressions in Core Web Vitals and bundle size.

Core Features & Use Cases

• Enforces per-route JS bundle budgets in CI to block merges when budgets are exceeded.
• Evaluates new dependencies for size, tree-shakability, and whether smaller alternatives exist before they are added.
• Checks hot-path DB queries for p95 latency budgets and requires baseline measurements or caching justification.
• Recommends targeted memoization after profiling, avoiding blanket memoization.
• Encourages proper image optimization and caching strategies to minimize layout shifts and load times.
• Defines a multi-layer cache TTL with explicit invalidation rules and documentation.

Quick Start

Apply this guard to a target project and review all hot-path changes against the seven core budget rules.