audit · v1.1.0 · 2026-11-09 · sha256 f7e77490006229b3
audit v1.1.0A
Immutable. This exact content never changes and is served at /api/v1/blob/f7e77490006229b3.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_khcazpkpfj2cph5o/f7e77490006229b399baecddf5131f17f9b69c3f3b05eaf5fe026f0c0dfee3e6.json
Then /plugin install audit@markdownregistry-khcazpkpfj2cph5o in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
---
name: audit
version: 1.1.0
description: >
Vault health check. Validates structure, detects stale reasoning artifacts
by priority level, runs forget, processes inbox, and suggests cleanup.
Triggers: "vault audit", "check vault", "clean up vault", "process inbox",
"what's stale", "vault health".
user_invocable: true
---
# /audit
Check structure. Flag staleness. Process inbox. Suggest cleanup.
## Steps
### 1. Structure Check
Verify each project under `Projects/` has:
- `_context.md` (required)
- Active Reasoning Artifacts table in `_context.md`
- Subfolders created on-demand (don't flag missing empty folders)
### 2. Staleness Scan
For each project `_context.md`, check Active Reasoning Artifacts table:
**Expiry check (first — overrides priority-based staleness):**
- Scan for `expires: YYYY-MM-DD` in artifact text
- If past expiry date → flag as **EXPIRED** regardless of priority
- Show: `"EXPIRED: #X — <artifact summary> (expired YYYY-MM-DD). Still valid?"`
**Priority-based staleness (for artifacts without expiry):**
| Priority | Age | Action |
|----------|-----|--------|
| critical | > 90 days | Flag for review — ask if invalidation trigger has fired |
| volatile | > 30 days | Flag for resolution — upgrade to critical or delete |
| settled | > 90 days | Suggest archiving to Decisions/ folder |
| noise | Any age | Flag for immediate removal |
| superseded | Any age | Should already be evicted — flag if still in L1 |
### 3. Inbox Processing
Check `_inbox/` for unprocessed items. For each:
- Identify type (research, note, decision, reference)
- Route to correct project and subfolder
- Add proper frontmatter
- Update project `_context.md` document index
### 4. Fluff Detection
Flag documents that may be stale or redundant:
- Files with `status: draft` older than 30 days
- Duplicate content across projects
- Documents with no wikilinks (orphaned)
- MOC files with no backlinks (orphaned hubs)
- `experiment-context` files past their teardown date
- `[S]` seeds dormant > 90 days (not activated, not decided)
### 5. Forget
Run forget on the vault to find decisions whose invalidation trigger may have fired:
```bash
python3 .agents/skills/forget/decay.py --format json <vault root>
```
List each LIKELY STALE and REVIEW candidate in the report with the signal that flagged it. Mark nothing as superseded here; the user runs `/forget` to go through them one by one.
### 6. Report
```
## Vault Audit — {date}
**Structure:** {OK or issues found}
**Stale artifacts:** {count by priority level}
**Possibly stale decisions (forget):** {LIKELY STALE count} likely, {REVIEW count} to review. Run `/forget` to go through them.
**Inbox:** {count processed, count remaining}
**Suggestions:** {cleanup actions}
```