164-java-profiling-verify

star 404

Use when you need to verify Java performance optimizations by comparing profiling results before and after refactoring — including baseline validation, post-refactoring report generation, quantitative before/after metrics comparison, side-by-side flamegraph analysis, regression detection, or creating profiling-comparison-analysis and profiling-final-results documentation. This should trigger for requests such as Verify performance fix; Verify the performance; Verify the memory; Verify the threading. Part of cursor-rules-java project

jabrena By jabrena schedule Updated 6/15/2026

name: 164-java-profiling-verify description: Use when you need to verify Java performance optimizations by comparing profiling results before and after refactoring — including baseline validation, post-refactoring report generation, quantitative before/after metrics comparison, side-by-side flamegraph analysis, regression detection, or creating profiling-comparison-analysis and profiling-final-results documentation. This should trigger for requests such as Verify performance fix; Verify the performance; Verify the memory; Verify the threading. Part of cursor-rules-java project license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.16.0

Java Profiling Workflow / Step 4 / Verify results

Verify performance optimizations through rigorous before/after comparison: ensure baseline and post-refactoring profiling data use identical test conditions, generate post-refactoring reports, compare metrics (memory, CPU, GC, threading), perform side-by-side flamegraph analysis, document findings in profiling-comparison-analysis-YYYYMMDD.md and profiling-final-results-YYYYMMDD.md, and validate success criteria.

What is covered in this Skill?

  • Pre-refactoring baseline: run profiler with same load before changes
  • Post-refactoring: generate new reports with identical test conditions
  • Comparison: memory (leaks, allocations, GC), CPU (hotspots, contention), visual flamegraph comparison
  • Documentation: profiler/docs/profiling-comparison-analysis-YYYYMMDD.md, profiler/docs/profiling-final-results-YYYYMMDD.md
  • File naming: baseline/after suffixes, timestamp-based organization
  • Validation: verify reports exist, compare metrics, identify regressions

Scope: Identical test conditions are critical. Document test scenarios. Validate application runs with refactored code before generating new reports.

Constraints

Use identical test conditions between baseline and post-refactoring. Verify both report sets are complete. Document test scenarios.

  • CONSISTENCY: Use identical test conditions and load patterns for baseline and post-refactoring
  • VALIDATE: Ensure both baseline and post-refactoring reports exist and are non-empty before comparison
  • DOCUMENT: Record test scenarios and load patterns for reproduction
  • BEFORE APPLYING: Read the reference for comparison templates and validation steps
  • EDGE CASE: If request scope is ambiguous, stop and ask a clarifying question before applying changes
  • EDGE CASE: If required inputs, files, or tooling are missing, report what is missing and ask whether to proceed with setup guidance

When to use this skill

  • Verify performance fix
  • Verify the performance
  • Verify the memory
  • Verify the threading
  • Verify the GC
  • Verify the profiling
  • Verify the profiling
  • Performance benchmark

Workflow

  1. Read verification reference and confirm baseline data

Read references/164-java-profiling-verify.md and verify baseline artifacts exist and are non-empty.

  1. Generate post-refactoring profiling data

Run profiling with identical load/test conditions to produce comparable post-refactoring artifacts.

  1. Compare before/after metrics and visuals

Perform quantitative comparisons for memory/CPU/GC/threading and side-by-side flamegraph analysis.

  1. Document final verification outcome

Create comparison and final results reports with regressions, gains, and reproducible scenario details.

Reference

For detailed guidance, examples, and constraints, see references/164-java-profiling-verify.md.

Install via CLI
npx skills add https://github.com/jabrena/cursor-rules-java --skill 164-java-profiling-verify
Repository Details
star Stars 404
call_split Forks 81
navigation Branch main
article Path SKILL.md
More from Creator