audit-agent-memory

Audit Agent Memory

Audit one agent's project memory directory for four categories of hygiene issues. Produces a structured advisory report with recommended actions. Does not modify any files.

If invoked without an argument, report:

Usage: /audit-agent-memory <agent-name>

Example: /audit-agent-memory qa-lead

Provide the agent name (e.g. qa-lead, tech-lead, product-owner) to audit
that agent's project memory directory.

And exit without reading any file.

Process

1. Read Memory

Derive the memory directory path from the argument:

.claude/agent-memory/engineering-leaders-<agent-name>/

Attempt to read .claude/agent-memory/engineering-leaders-<agent-name>/MEMORY.md.

If the directory or MEMORY.md does not exist, report:

No memory directory found at .claude/agent-memory/engineering-leaders-<agent-name>/.
Run /onboard or /onboard-<agent-name> to create one.

And exit.

Glob the directory for all *.md files:

.claude/agent-memory/engineering-leaders-<agent-name>/*.md

Read every *.md file found. Collect:

• The content of MEMORY.md (used for dead-link detection)
• The content and byte size of every *.md file (used for Check 4 (size))
• A list of all *.md file paths found (used for dead-link detection)

2. Run Checks

Run the four checks below against the collected files. Each check records findings independently. A single file can produce findings under multiple checks.

Check 1: State-Like Content

Heuristic: A file contains state-like content if it matches any of the following patterns:

Dated phrases (any of these strings, case-insensitive):

• as of
• last quarter
• last month
• last sprint
• this quarter
• this month
• this sprint
• current sprint
• current phase
• in progress
• blocked by
• Q1, Q2, Q3, Q4 followed by a four-digit year (e.g. Q3 2025)

Enumerated file paths: Three or more lines in the file that match the pattern path/to/file (a sequence of path segments separated by /, not starting with http). Count consecutive or near-consecutive path-formatted lines; if three or more appear in the file, this heuristic triggers. Threshold: 3 or more enumerated paths.