Ideaverse Maintenance Skill

Run audits, diagnostics, and maintenance workflows to keep Ideaverse-based Obsidian vaults healthy. Assume familiarity with the core Ideaverse methodology.

Requirements

• Python 3.8 or later
• No external dependencies (uses only Python standard library)

Vault Health Diagnostics

Quick Health Check

Run these in sequence for a complete vault audit. Scripts can be invoked directly (if executable) or via python3:

# 1. Find broken links (critical)
./scripts/find_broken_links.py /path/to/vault
# or: python3 scripts/find_broken_links.py /path/to/vault

# 2. Find orphan notes (structural)
./scripts/find_orphans.py /path/to/vault

# 3. Check frontmatter compliance (consistency)
./scripts/check_frontmatter.py /path/to/vault

# 4. Detect MOC bloat (scale)
./scripts/detect_moc_bloat.py /path/to/vault

# 5. Find squeeze points (opportunities)
./scripts/validate_squeeze_points.py /path/to/vault

# 6. Suggest archival candidates (hygiene)
./scripts/suggest_archival.py /path/to/vault

Note: If python3 is not available on your system, use python if it points to Python 3.x.

Script Descriptions

Script	Purpose	Output
find_broken_links.py	Discover wikilinks pointing to non-existent notes	List of source files with broken links
find_orphans.py	Identify notes with no incoming links	List of orphan note paths
check_frontmatter.py	Verify required properties (up, created)	Issues grouped by type
detect_moc_bloat.py	Find MOCs with 50+ direct links	MOCs sorted by link count
validate_squeeze_points.py	Find unstructured clusters needing MOCs	Terms linked 10+ times without MOC
suggest_archival.py	Identify stale notes for archival consideration	Notes sorted by staleness indicators

All scripts accept a vault path argument and return structured output. Exit code 0 = healthy, 1 = issues found.

Maintenance Cadences

Daily (5 minutes)

• Review today's daily log for unprocessed fleeting notes
• Quick scan for any broken links introduced today

Weekly (15-30 minutes)

• Run find_broken_links.py and fix any issues
• Run find_orphans.py - triage: link, archive, or delete
• Spot-check frontmatter on recently created notes

Monthly (1-2 hours)

• Full diagnostic suite (all 6 scripts)
• Review MOC bloat - split any MOCs over 50 links
• Process squeeze points - create MOCs where warranted
• Review archival suggestions - archive confirmed stale notes
• Generate and save vault health report

Quarterly (Half day)

• Comprehensive vault audit
• Review and clean Archive folder
• Assess MOC hierarchy - simplify or restructure as needed
• Update any vault-level documentation

Deep Dives

Use reference docs for detailed decision trees, workflows, and maintenance playbooks:

• references/vault-hygiene.md - Hygiene workflows, cadences, and reporting
• references/troubleshooting.md - Diagnosis and resolution guides