// Use when appending structured perf investigation notes and evidence.
| name | perf-investigation-logger |
| description | Use when appending structured perf investigation notes and evidence. |
| version | 5.1.0 |
Append structured investigation notes to {state-dir}/perf/investigations/<id>.md.
Follow docs/perf-requirements.md as the canonical contract.
## <Phase Name> - <YYYY-MM-DD>
**User Quote:** "<exact quote>"
**Summary**
- ...
**Evidence**
- Command: `...`
- File: `path:line`
**Decision**
- ...
AI_STATE_DIR for state path (default .claude).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 profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence.