Skip to content

Performance Audit Review Checklist

Use this checklist to review artifacts produced during a performance audit lifecycle.

Profile Report (docs/audits/PERF-{NNN}/profile-report.md)

  • [ ] Actual bottlenecks: Findings are based on code analysis, not premature optimization guesses
  • [ ] Specific locations: Each bottleneck includes file:line or file:function references
  • [ ] Categorized: Bottlenecks are categorized (N+1, missing index, sync I/O, etc.)
  • [ ] Impact assessed: Severity based on path frequency and latency contribution
  • [ ] Critical paths traced: Request handling chains are fully traced
  • [ ] Existing optimizations noted: Current caching and indexing acknowledged

Optimization Plan (docs/audits/PERF-{NNN}/optimization-plan.md)

  • [ ] Expected improvement stated: Each recommendation includes specific improvement description
  • [ ] Trade-offs documented: Caching complexity, consistency risks, etc. are noted
  • [ ] Quick wins identified: Low-effort, high-impact optimizations separated
  • [ ] Benchmark requirements: Each optimization has a corresponding benchmark requirement
  • [ ] Priority matrix sensible: Impact/effort ratio drives the ordering

Stories (docs/audits/PERF-{NNN}/stories/)

  • [ ] Paired with benchmarks: Each optimization story has a companion benchmark story
  • [ ] Quick wins first: Low-effort optimizations are prioritized
  • [ ] Self-contained: Each story can be implemented and verified independently
  • [ ] Measurable: Success criteria include specific performance metrics

Overall

  • [ ] Data-driven: No premature optimization — all changes backed by profiling evidence
  • [ ] Consistency: Profile, plan, and stories tell a coherent story
  • [ ] Verification plan: Clear strategy for measuring improvement after implementation