Health

/health — Vault Health Check

Generate comprehensive health report for the vault.

Context

Config: @_core/config.yaml

Session Task Progress

TaskCreate: "Scan vault files"
  activeForm: "Scanning vault files..."

TaskCreate: "Check links and orphans"
  activeForm: "Validating links..."

TaskCreate: "Generate health report"
  activeForm: "Generating health report..."

Processing Steps

1. Scan Vault

• Glob all .md files
• Exclude: _core/, _templates/, _archive/

1. Check Broken Links

• Extract all [[wikilinks]] from each file
• Verify each target exists
• Report: source → broken target

1. Find Orphan Notes

• Notes with no inbound links
• Exclude: index files, standalone: true

1. Check Missing Sections

• Typed notes (doc, decision, blocker, meeting) should have ## Links
• Report missing required sections

1. Calculate Statistics

• Notes by type
• Notes by project
• Link density (links per note)

1. Check Synthesis Freshness

• For each 01-index/{project}.md, check if ## Synthesis section exists
• If synthesis is missing or says "No synthesis yet", flag as stale
• Check vault log (01-index/_vault-log.md) for last index-regen entry per project
• If no regen in 7+ days, flag as stale

1. Check Update Status

• Read VERSION file for local version
• Query GitHub API for latest release: curl -sS "https://api.github.com/repos/{repo}/releases/latest" (non-fatal on failure)
• Compare: "Up to date" | "Update available: vX → vY" | "Could not check"

1. Append to Vault Log

• Append health entry to 01-index/_vault-log.md (see .claude/rules/vault-log.md)

1. Generate Report

• Write to 01-index/_graph-health.md

Output Format

# Graph Health Report

> Generated: {datetime}

## Broken Links
| Source | Broken Target |
|--------|---------------|
| {path} | [[{target}]]  |

## Orphan Notes
- {path} — no inbound links

## Missing ## Links Sections
- {path} — type: {type}

## Statistics

### By Type
| Type | Count |
|------|-------|
| daily | {n} |
| doc | {n} |

### By Project
| Project | Count |
|---------|-------|
| {proj} | {n} |

### Link Density
- Total links: {n}
- Average per note: {avg}

## Synthesis Health

| Project | Has Synthesis | Last Index Regen | Status |
|---------|---------------|------------------|--------|
| {proj} | Yes/No | {date or "Never"} | Fresh/Stale |

## Framework Status
- **Version**: v{local}
- **Update**: {status — "Up to date" | "Update available: vX → vY" | "Could not check"}

## Actions
1. [ ] Fix broken link: {source} → {target}
2. [ ] Add links to: {orphan}

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kv0906
• Source: kv0906/pm-kit
• License: MIT
• Homepage: https://willtran.xyz

Install and usage instructions live in the source repository linked above.