| name | Performance Engineering Standards |
| description | Universal standards for high-performance development. Use when optimizing, reducing latency, fixing memory leaks, profiling, or improving throughput. |
| metadata | {"labels":["performance","optimization","scalability","profiling"],"triggers":{"keywords":["performance","optimize","profile","scalability","latency","throughput","memory leak","bottleneck"],"files":["**/*.ts","**/*.tsx","**/*.go","**/*.dart","**/*.java","**/*.kt","**/*.swift","**/*.py"]}} |
Performance Engineering Standards
Universal standards for high-performance software development across all frameworks.
Priority: P0 (CRITICAL)
Universal standards for building high-performance software across all frameworks and languages.
🚀 Core Principles
- Efficiency by Design: Minimize resource consumption (CPU, Memory, Network) without sacrificing readability.
- Measure First: Never optimize without a baseline. Use profiling tools before and after changes.
- Scalability: Design systems to handle increased load by optimizing time and space complexity.
💾 Resource Management
- Memory Efficiency:
- Avoid memory leaks: explicit cleanup of listeners, observers, and streams.
- Optimize data structures: use the most efficient collection for the use case (e.g.,
Set for lookups, List for iteration).
- Lazy Initialization: Initialize expensive objects only when needed.
- CPU Optimization:
- Algorithm Complexity: Aim for $O(1)$ or $O(n)$ where possible; avoid $O(n^2)$ in critical paths.
- Offload Work: Move heavy computations to background threads or workers.
- Minimize Re-computation: Use memoization for pure, expensive functions.
🌐 Network & I/O
- Payload Reduction: Use efficient serialization (JSON minification, Protobuf) and compression.
- Batching: Group multiple small requests into single bulk operations.
- Caching Strategy:
- Implement multi-level caching (Memory -> Storage -> Network).
- Use appropriate TTL (Time To Live) and invalidation strategies.
- Non-blocking I/O: Always use asynchronous operations for file system and network access.
⚡ UI/UX Performance
- Minimize Main Thread Work: Keep animations and interactions fluid by keeping the main thread free.
- Virtualization: Use lazy loading or virtualization for long lists/large datasets.
- Tree Shaking: Ensure build tools remove unused code and dependencies.
📊 Monitoring & Testing
- Benchmarking: Write micro-benchmarks for performance-critical functions.
- SLIs/SLOs: Define Service Level Indicators (latency, throughput) and Objectives.
- Load Testing: Test system behavior under peak and stress conditions.
