perf-investigation-logger

Structured performance investigation notes are documented by appending entries to a per-incident Markdown file using a canonical phase, summary, evidence, and decision format. This captures verbatim user quotes and evidence pointers consistently throughout the incident workflow.

Verbatim user quotes are logged within dedicated sections of the investigation Markdown file. The skill enforces a standardized structure, ensuring each phase entry captures the exact user quote alongside the corresponding summary and evidence pointers.

The best way to structure phase-by-phase notes is using the canonical '## <Phase Name> - <YYYY-MM-DD>' format. Each entry contains dedicated sections for the User Quote, Summary, Evidence, and Decision, ensuring chronological tracking of the investigation.

Performance investigation notes are stored in a per-incident Markdown file located under the AI state directory. The default state path enforced is the .claude directory, with files saved to the perf/investigations/ subfolder using the incident ID.

No external dependencies are required to append structured performance investigation notes. The skill operates independently to format and write incident logs, requiring only the designated AI state directory for output file storage.

This structured logging approach is specifically tailored for performance incident workflows. It targets perf incident documentation by embedding phase summaries, decisions, and evidence pointers, making it less suitable for non-performance investigations.