spine-health

Spine Health — Vault Curator Scan

Audit the Spine Architecture vault for quality and completeness.

Vault Path Resolution

Resolve the vault path using this config chain:

1. $SPINE_VAULT_PATH environment variable
2. ~/.spine/config.json → read the vaultPath field
3. Default: ~/Documents/SpineVault/

If the vault doesn't exist, tell the user to run /spine-init first.

Scope

If $ARGUMENTS specifies a feature or repo, limit the scan to that area. Otherwise, scan the entire vault.

Check 1: Coverage Gaps

Compare recent git history against existing Obsidian docs to find undocumented work.

1. Run git log --oneline --since="2 weeks ago" in the current repo
2. Group commits by feature area (based on file paths changed)
3. For each group, check if a corresponding Obsidian doc exists
4. Report any significant work (not just typo fixes) that has no documentation

Output:

## Coverage Gaps
- [repo/feature] 3 commits touching auth logic — no doc since YYYY-MM-DD
- [repo/feature] New API endpoint added — no architecture doc

Check 2: Stale Docs

Find docs that reference code that has changed significantly since the doc was written.

1. Read each doc's **Files changed:** section
2. For each referenced file, check git log --oneline --since="{doc date}" -- {filepath}
3. If the file has 3+ commits since the doc was written, flag as potentially stale

Output:

## Potentially Stale
- Fix - Session Bug (2026-03-18) — session.hook.ts has 5 commits since

Check 3: Duplicate/Overlapping Docs

Find docs within the same feature that describe overlapping issues.

1. Read all docs under each feature folder
2. Check for:
   • Same files referenced in multiple docs
   • Similar root causes described
   • Wikilinks that create circular clusters
3. Suggest consolidation where appropriate

Check 4: Spine Note Integrity

Verify each spine note accurately reflects its children.

1. List all files in each feature folder
2. Compare against wikilinks in the spine note
3. Flag:
   • Docs that exist but aren't linked from the spine
   • Wikilinks that point to non-existent docs (ghost links)
   • Missing sections (e.g., feature has fixes but spine has no "## Fixes" section)