About perf-investigation-logger
perf-investigation-logger appends structured performance investigation notes to a file under the configured state directory. It preserves exact user quotes and records phase summaries, decisions, and evidence pointers.
Key features
- 01Appends structured investigation notes
- 02Preserves verbatim user quotes
- 03Records phase summaries
- 04Captures decisions and rationale
- 05Links evidence files and metrics
Use cases
- 01Logging a performance investigation phase
- 02Recording decisions with supporting evidence
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ agent-sh/ agentsys --skill perf-investigation-loggerAfter installing, type/perf-investigation-loggerin Claude Code to confirm it loaded.
Details
From the project READMEperf-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_DIRfor state path (default.claude). - Do not paraphrase user quotes.
Comments
Markdown supported