---

name: performance-principles description: Performance guidelines and patterns for this system.

Performance Principles

General Principles

• Optimize for correct, clear code first; then optimize hot paths.
• Measure before optimizing when possible.
• Prefer algorithmic improvements over micro-optimizations.

Common Pitfalls

• N+1 queries in database access.
• Unbounded in-memory collections for large datasets.
• Synchronous calls in latency-sensitive paths.
• Repeated expensive computations without caching.

Guidelines by Layer

Backend

• Use efficient query patterns and indices.
• Batch calls where practical.
• Apply backpressure and rate limiting where needed.

Frontend

• Avoid unnecessary re-renders.
• Lazy-load heavy components and routes.
• Cache data appropriately (client & server).

Monitoring & Metrics

• Ensure critical paths have basic instrumentation:
  • Latency, error rate, throughput.
• Define performance budgets (e.g., 95th percentile latency thresholds).

When to Escalate

• If a change risks breaching performance budgets.
• If complexity grows significantly (e.g., big-O behavior worsens).