agents/rules/performance-avoid-quadratic.md
Impact: CRITICAL
We build for large organizations and teams. What works fine with 10 users or 50 records can collapse under the weight of enterprise scale. Performance is not something we optimize later. It's something we build correctly from the start.
When building features, always ask: "How does this behave with 1,000 users? 10,000 records? 100,000 operations?"
Common O(n²) patterns to avoid:
.map inside .map, .forEach inside .forEach).some, .find, or .filter inside loops or callbacksIncorrect (O(n²) - exponential slowdown):
// Bad: O(n²) - checks every slot against every busy time
const available = availableSlots.filter(slot => {
return !busyTimes.some(busy => checkOverlap(slot, busy));
});
// For 100 slots and 50 busy periods: 5,000 checks
// For 500 slots and 200 busy periods: 100,000 checks (20x increase!)
Correct (O(n log n) - scales gracefully):
// Good: O(n log n) - sort once, break early
const sortedBusy = [...busyTimes].sort((a, b) => a.start - b.start);
const available = availableSlots.filter(slot => {
// Binary search or early exit
const index = binarySearch(sortedBusy, slot.start);
return !hasOverlapAt(sortedBusy, index, slot);
});
Better data structures and algorithms:
.find or .includes on arraysReference: Cal.com Engineering Blog