// Use when profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence.
| name | perf-profiler |
| description | Use when profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence. |
| version | 5.1.0 |
| argument-hint | [tool] [command] |
Run profiling tools and capture hotspots with evidence.
Follow docs/perf-requirements.md as the canonical contract.
const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const tool = args[0] || '';
const command = args.slice(1).join(' ');
tool: <profiler>
command: <command>
hotspots:
- file:line - reason
artifacts:
- <path to flame graph or profile>
Use when generating performance hypotheses backed by git history and code evidence.
Use when synthesizing perf findings into evidence-backed recommendations and decisions.
Use when managing perf baselines, consolidating results, or comparing versions. Ensures one baseline JSON per version.
Use when running performance benchmarks, establishing baselines, or validating regressions with sequential runs. Enforces 60s minimum runs (30s only for binary search) and no parallel benchmarks.
Use when mapping code paths, entrypoints, and likely hot files before profiling.
Use when appending structured perf investigation notes and evidence.