perf-investigation-logger
Append structured investigation notes to {state-dir}/perf/investigations/<id>.md .
Follow docs/perf-requirements.md as the canonical contract.
Required Content
-
Exact user quotes (verbatim)
-
Phase summary
-
Decisions and rationale
-
Evidence pointers (files, metrics, commands)
Output Format
<Phase Name> - <YYYY-MM-DD>
User Quote: "<exact quote>"
Summary
- ...
Evidence
- Command:
... - File:
path:line
Decision
- ...
Constraints
-
Use AI_STATE_DIR for state path (default .claude ).
-
Do not paraphrase user quotes.