performance

name	performance
description	Performance optimization strategies and techniques
category	skill
allowed-tools	Read, Write, Glob, Grep, Bash
user-invocable	true
context	inject
version	1.0.0

Performance Skills

Overview

Performance optimization knowledge for building fast, scalable applications that provide excellent user experience.

Key Metrics

Metric	Target	Description
TTFB	< 200ms	Time to First Byte
FCP	< 1.8s	First Contentful Paint
LCP	< 2.5s	Largest Contentful Paint
FID	< 100ms	First Input Delay
CLS	< 0.1	Cumulative Layout Shift
API Response	< 200ms	P95 response time
Database Query	< 50ms	P95 query time
Memory Usage	< 80%	Application memory threshold

Categories

Fundamentals

• Performance metrics and measurement
• Bottleneck analysis techniques
• Benchmarking methodologies

Caching

• Application caching strategies
• Redis/Memcached implementation
• HTTP caching headers
• CDN configuration
• Cache invalidation patterns

Database Performance

• Query optimization
• Indexing strategies
• Connection pooling
• N+1 query prevention
• Read replicas

API Performance

• Pagination strategies
• Response compression
• Batch operations
• Async processing
• Rate limiting

Frontend Performance

• Bundle optimization
• Code splitting
• Lazy loading
• Image optimization
• Core Web Vitals

Profiling & Monitoring

• CPU profiling
• Memory analysis
• APM tools
• Performance testing

Scaling

• Horizontal vs vertical
• Load balancing
• Auto-scaling
• Caching layers

Performance Pyramid

         ╱╲
        ╱  ╲         CDN / Edge
       ╱────╲
      ╱      ╲       Application Cache
     ╱────────╲
    ╱          ╲     Database Optimization
   ╱────────────╲
  ╱              ╲   Code Optimization
 ╱________________╲  Infrastructure

Quick Reference

Response Time Targets

Operation Type	Target	Maximum
Static assets	< 50ms	100ms
API read	< 100ms	200ms
API write	< 200ms	500ms
Search	< 200ms	500ms
Report generation	< 2s	5s
File upload	< 5s	30s

Caching Strategy by Data Type

Data Type	Cache Location	TTL
Static assets	CDN	1 year
User session	Redis	30 min
User profile	Redis	1 hour
Product catalog	Redis + CDN	6 hours
Search results	Redis	5 min
Config	Memory	24 hours

Skill Files

Fundamentals

• Performance Metrics
• Bottleneck Analysis
• Benchmarking

Caching

• Caching Strategies
• Redis Caching
• HTTP Caching
• CDN Caching
• Cache Invalidation

Database

• Query Optimization
• Indexing Strategies
• Connection Pooling
• N+1 Problem

API

• Pagination
• Response Compression
• Batch Operations
• Async Processing

Frontend

• Bundle Optimization
• Lazy Loading
• Image Optimization
• Core Web Vitals

Profiling

• CPU Profiling
• Memory Profiling
• APM Tools

Scaling

• Horizontal Scaling
• Vertical Scaling
• Load Balancing
• Auto Scaling

Integration with F5 Framework

Quality Gate Integration

Performance requirements should be defined in quality gates:

# .f5/quality/gates-status.yaml
gates:
  G2:
    performance:
      api_p95_response: "< 200ms"
      database_p95_query: "< 50ms"
      memory_usage: "< 80%"

Traceability

Performance requirements should be traceable:

// NFR-PERF-001: API response time must be under 200ms at P95
export async function getUser(id: string): Promise<User> {
  // implementation
}