vault-maintenance

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.