---
name: vault-maintenance
description: >-
  Run comprehensive health checks on the Obsidian vault — orphan notes, stale
  drafts, broken links, type mismatches. Triggers: "vault maintenance", "check
  vault health", "find orphan notes", "audit my vault", "what needs fixing".
  Only runs when explicitly requested.
disable-model-invocation: true
---

# Vault Maintenance

Scan the vault for structural issues and report findings with actionable fixes. Use Grep and Glob for efficiency — avoid reading files fully when a frontmatter scan suffices.

## Checks

### 1. Orphan notes
Notes in `Notes/*/` missing `type` or `tags` frontmatter. These won't appear in Bases views.

### 2. Stale drafts
Notes with `status: draft` where `created` is 30+ days old. Finish or archive.

### 3. Duplicate detection
Notes with very similar titles (case-insensitive). Flag pairs for review.

### 4. Invalid types
Notes with a `type` value not in CLAUDE.md's valid types.

### 5. Subfolder mismatch
Notes where the subfolder name doesn't match the `type` frontmatter field (e.g., file in `Notes/config/` with `type: reference`). Fix by moving the file or updating the type.

### 6. Broken wikilinks
`[[...]]` links that don't resolve to any vault file.

### 7. Inbox status
Count unprocessed files in `Inbox/`.

## Report format

Structured report with counts per check, specific items found, summary. After report, offer to fix: use Edit for frontmatter fixes, Bash `mv` to relocate misplaced files.