/memory-audit

name: memory-audit
description: Show everything Claudia knows with provenance tracing and entity counts. Triggers on "what do you know?", "show memories", "memory audit", "what do you remember about". See also: `memory-health` for system-level stats and data quality; `diagnose` for connectivity troubleshooting.
argument-hint: "[entity name]"
effort-level: medium

Memory Audit

Show what Claudia knows. Verify claims trace to sources. Surface gaps.

Usage

• `/memory-audit` -- Full system audit
• `/memory-audit [entity name]` -- Audit everything about a specific person, project, or entity

Full Audit

When run without arguments, produce a system-level overview of everything in memory.

1. Summary Counts

Query the memory system for aggregate counts:

claudia memory entities search --query "*" --project-dir "$PWD"
claudia memory recall "*" --compact --limit 1 --project-dir "$PWD"
claudia memory document search --project-dir "$PWD"

Parse the JSON output from each command to get counts.

Display:

## Memory Audit - [Date]

| Category       | Count |
|----------------|-------|
| Entities       | N     |
| Memories       | N     |
| Commitments    | N     |
| Documents      | N     |
| Relationships  | N     |

2. People (Top 10 by Importance)

claudia memory entities search --types "person" --limit 10 --project-dir "$PWD"
For each person:
  claudia memory about "[person name]" --project-dir "$PWD"

Display as a table:

### People

| Name | Memories | Last Mentioned | Key Fact |
|------|----------|----------------|----------|
| ...  | ...      | ...            | ...      |

3. Projects (Top 10)

Same pattern with types=["project"]:

claudia memory entities search --types "project" --limit 10 --project-dir "$PWD"

4. Active Patterns

claudia memory session context --project-dir "$PWD"

5. Provenance Sample

Pick the 3 most recent high-importance memories and trace them:

claudia memory recall "*" --compact --limit 3 --project-dir "$PWD"
For each result, run:
  claudia memory provenance trace --memory-id "[id]" --project-dir "$PWD"

Display:

### Provenance Check (3 recent memories)

**Memory:** "[content snippet]"
- Source: [episode/document/user_input]
- Document: [filename] (if linked)
- Entities: [linked entities]
- Verified: [yes/no/pending]

---

Entity Audit

When run with an entity name (e.g., `/memory-audit Sarah Chen`):

1. Profile

claudia memory about "[entity name]" --project-dir "$PWD"

Display:

## Audit: [Entity Name]

**Type:** person/project/organization
**Description:** [from entity record]
**Importance:** [score]
**First seen:** [created_at]
**Last mentioned:** [updated_at]

2. All Memories (grouped by type)

From the `claudia memory about` JSON response, group memories:

### Facts (N)
- [content] (importance: X, created: date)

### Commitments (N)
- [content] (importance: X, created: date)

### Observations (N)
- [content] (importance: X, created: date)

3. Relationships

### Relationships (N)
- [relationship_type] with [other_entity] (strength: X)

4. Linked Documents

claudia memory document search --entity "[entity name]" --project-dir "$PWD"

Display:

### Documents (N)
- [filename] ([source_type], [date]) - [summary snippet]

5. Provenance Chains

For each commitment or high-importance memory (importance > 0.7):

claudia memory provenance trace --memory-id "[memory ID]" --project-dir "$PWD"

Display:

### Provenance

**"[memory content]"** (commitment, importance: 0.9)
|- Source: session_summary (episode 42)
|- Episode: "Discussed Q2 goals with Sarah..."
|- Document: meeting-sarah-q2.md (transcript)
|- Verified: yes (2026-01-15)

---

Output Rules

• Use the structured output format with emoji headers
• End structured output blocks with a markdown horizontal rule
• If the memory system is not available, say so clearly
• Keep entity audit focused: no padding, no speculation
• Provenance chains are the most important part: if a memory has no source, flag it

Tone

• Factual and clean
• Like a database report, not a narrative
• Flag gaps honestly: "No source document linked" is useful information