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

ideaverse-maintenance

Safety Notice

Copy this and send it to your AI assistant to learn