---
name: rlm-audit
description: Audit RLM cache coverage - compare manifest against filesystem
trigger_phrases:
  - "audit rlm cache"
  - "check rlm coverage"
  - "rlm inventory audit"
  - "show missing rlm files"
  - "check rlm gap"
---

# rlm-audit

## Purpose
Systematically audit the RLM (Recursive Language Model) semantic cache to identify gaps between the project manifest and the actual summary files stored on disk. 

## Capabilities
- **Coverage Analysis**: Calculates the percentage of project documentation currently summarized.
- **Gap Identification**: Detects files that are included in the manifest but missing from the cache.
- **Exporting**: Generates CSV lists of missing files for batch processing.
- **Validation**: Ensures the cache directory structure mirrors the source repository.

## Usage
Run the audit for a specific profile to see what's missing:

```bash
python scripts/audit_cache.py --profile wiki --report audit_report.txt --csv missing_files.csv
```

## Related
- **rlm-distill-agent**: Use to fill the gaps identified by this audit.
- **rlm-cleanup-agent**: Use to remove stale entries from the cache.