Skip to main content
subagent CX Codex

memory-auditor — Claude Code subagent: memory checks

The memory-auditor subagent for Claude Code checks memory against code and Git, flagging stale or duplicate entries. Run it after a major refactor.

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@Claudest
Open on GitHub

What memory-auditor does

memory-auditor checks paths, functions, versions, settings, and conventions mentioned in memory against the project and Git history. It looks for deleted or renamed entities, changed behavior, and relative dates that have lost their meaning. Its tools are Read, Grep, Glob, and Bash(git:*).

The agent also spots overlapping entries and flags material that is outdated, repetitive, or too generic to guide future work. Code or Git evidence is required for factual findings; principles and preferences are judged against the memory corpus itself. When an entity is missing from the working tree, the agent checks whether it may belong to an external dependency before calling it stale.

For Claude Code, add the Claudest marketplace and install claude-memory@Claudest; the agent file path is .claude/agents/memory-auditor.md. Audits outside a Git repository have no project history to consult, so conclusions about changes need care.

What it helps with

  • find memory references to deleted or renamed files
  • check whether remembered versions and settings still match the project
  • flag relative dates that need an absolute date
  • catch disagreements between memory entries and code
  • identify stale or duplicate entries to merge or remove

Example prompts for the agent

  • Check the memory entries after this refactor and find stale file or function references.
  • Compare the versions and settings in memory with the code and Git history.
  • Find overlapping memory entries about this decision and suggest what to merge or remove.

How to install memory-auditor

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@Claudest

2Manually: put the files in place

.claude/agents/memory-auditor.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 memory-auditor

How do I install memory-auditor in Claude Code?

Run /plugin marketplace add gupsammy/Claudest, then /plugin install claude-memory@Claudest. The agent file is at .claude/agents/memory-auditor.md.

What does memory-auditor do?

It checks memory entries against the current codebase and Git history, then flags stale facts, relative dates, and entries that may be merged or removed.

What evidence does memory-auditor use for factual findings?

It searches for files and definitions with Glob and Grep, checks versions in project manifests, and consults Git history. Factual findings require supporting evidence.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set47

The whole set →
convert-video convert-video handles video tasks in Claude Code via FFmpeg: remuxes containers, trims clips, adjusts playback speed, and scales footage. CX Codex +1 ★ 276repo stars commit This skill reviews Git changes and creates Conventional Commits. Use it to split unrelated work into separate commits and push when requested. CX Codex +1 ★ 276repo stars signal-discoverer The signal-discoverer subagent for Claude Code mines recent sessions for undocumented user corrections, architectural decisions, behavioral patterns and preferences to save to project memory. CX Codex ★ 276repo stars skill-lint skill-lint audits SKILL.md files against seven structural quality dimensions, fixing critical defects immediately and flagging minor issues for approval. CX Codex ★ 276repo stars clean-branches clean-branches is a Claude Code skill that finds merged and stale git branches, marks protected ones, and asks before deletion. It helps clear accumulated branch clutter. CX Codex +1 ★ 276repo stars council council launches parallel personas to deliberate on technical questions, examine codebase files, and formulate an opinionated verdict. CX Codex +1 ★ 276repo stars claw-advisor claw-advisor is a Claude Code skill for OpenClaw setup, troubleshooting, and architecture questions. It handles requests about channels, gateways, models, and automation. CX Codex +1 ★ 276repo stars update-readme update-readme rewrites an existing README.md using the current code, git log and changelog. Useful once the docs drift away from what the repo actually does. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open