Perf Investigation Logger

composiohq/awesome-claude-pluginsOfficial

This logs your performance investigation work to structured markdown files, keeping exact user quotes, phase summaries, decisions, and evidence pointers in one place. It's built for the kind of debugging where you need an audit trail: what the user said verbatim, what metrics or commands you ran, and why you chose one fix over another. The format is rigid by design, with timestamped phases and specific sections for quotes, evidence, and rationale. It writes to a state directory and follows a canonical contract defined in perf-requirements.md. Good for when you're deep in a gnarly performance issue and need to document your path through it without losing context or misquoting the person reporting the problem.

GitHub stars: 1.7K
last updated: May 1, 2026

View on GitHub

Install

$ npx -y skills add composiohq/awesome-claude-plugins --skill perf-investigation-logger --agent claude-code

Installs into .claude/skills of the current project.

Files

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**
- ...