Skip to main content
subagent CX Codex

perf-investigation-logger — Claude Code subagent

perf-investigation-logger — a subagent for structured documentation of performance investigations. Captures verbatim user statements, findings, and evidence in a single log.

MIT ★ 2,003 updated 2026-07-26

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install perf@awesome-claude-plugins
Open on GitHub

What perf-investigation-logger does

perf-investigation-logger automatically creates performance investigation records in a format aligned with your contract in docs/perf-requirements.md. The subagent collects exact user quotes, phase summaries, decisions with rationale, and pointers to evidence—files, commands, metrics.

Logs are written to {state-dir}/perf/investigations/<id>.md with phase, date, quote, evidence, and decision. It reads and writes directly, respecting the AI_STATE_DIR variable (defaults to .claude) and logging constraints.

Requires Claude Code with file read and write permissions.

What it helps with

  • log performance investigations with user quotes verbatim
  • connect decisions to evidence and code locations
  • maintain a structured journal of analysis phases
  • comply with perf-requirements.md when recording findings

Example prompts for the agent

  • Investigate why rendering is slow in src/render.js and document the results
  • Create an investigation entry: user asked to check memory leak in components/List
  • Record a profiling phase with the node --prof app.js command and conclusions

How to install perf-investigation-logger

1Plugin marketplace

/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install perf@awesome-claude-plugins

2Manually: put the files in place

.claude/agents/perf-investigation-logger.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about perf-investigation-logger

How do I install perf-investigation-logger in Claude Code?

Run these steps in order: /plugin marketplace add composio-community/awesome-claude-plugins, then /plugin install perf@awesome-claude-plugins, then open .claude/agents/perf-investigation-logger.md.

What does perf-investigation-logger do?

It writes structured investigation records with user quotes, phase summaries, decisions and file/command references to a log managed by AI_STATE_DIR.

Do I need to prepare perf-requirements.md first?

Yes. The subagent follows docs/perf-requirements.md as the canonical contract for log format and requirements.

Source text

perf-investigation-logger.md · MIT
---
name: perf-investigation-logger
description: Append structured investigation notes with exact user quotes and rationale.
tools: Read, Write
model: sonnet
---

# Perf Investigation Logger

You MUST follow `docs/perf-requirements.md` as the canonical contract.

Append structured investigation notes to `{state-dir}/perf/investigations/<id>.md`.

## Required Content

1. Exact user quotes (verbatim)
2. Phase summary
3. Decisions and rationale
4. 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.

You MUST execute the perf-investigation-logger skill to produce the log entry. Do not bypass the skill.

© Community · MIT · composio-community/awesome-claude-plugins

Similar subagents

All subagents for Testing and QA →

From the same set68

The whole set →
list-subs list-subs inspects active skill-bus subscriptions across global and project settings. Use it to trace conditions and predict which skills would run. CX Codex +1 ★ 2,003repo stars pause-subs pause-subs turns the skill bus off, everywhere or for one project. Subscriptions stay in place and stop firing until you switch them back. CX Codex +1 ★ 2,003repo stars perf-analyzer perf-analyzer — a Claude Code subagent that turns profiling results and benchmark experiments into evidence-backed recommendations structured by a strict template. CX Codex ★ 2,003repo stars documentation-generator The documentation-generator command turns code, APIs, and project details into structured developer documentation. Use it when setup notes, examples, or endpoint references need to be written. CX Codex +1 ★ 2,003repo stars pause-subs pause-subs is a Claude Code skill that temporarily disables skill-bus subscriptions without removing their settings, for tasks interrupted by background triggers. CX Codex +1 ★ 2,003repo stars create-pr create-pr is a Claude Code command that turns working changes into a pull request. It branches the work, formats edited files, and prepares commits. CX Codex +1 ★ 2,003repo stars commit A slash command that builds your git commit: stages files, writes a conventional-commit message with an emoji, and runs the project's checks first. CX Codex +1 ★ 2,003repo stars list-subs list-subs inspects active skill-bus subscriptions across global or project scopes and simulates event matching for individual skills. CX Codex +1 ★ 2,003repo stars

Project sponsors

Companies that keep this analytics open