conducty-vault-graph

Conducty Vault Graph — Hygiene + Drift Detection

The vault is now load-bearing. Without periodic hygiene, it accumulates orphans (notes nothing links to), dead wikilinks (links to renamed/deleted notes), stale context (project hubs older than the threshold), unused designs (designs no plan ever consumed), and improvement experiments that nobody evaluated.

This skill runs a structured audit and produces a vault-health report.

[!important] Read [[conducty-obsidian]] first Audit relies on the vault's filename and link conventions.

When to Use

• Weekly hygiene cycle ("vault audit", "vault health")
• Before a major plan that will rely heavily on context graph navigation
• When backlinks in Obsidian start showing "no backlinks" on notes that should have them
• When [[conducty-context]] flags stale hubs and the user wants the full picture

Audits

Audit 1: Orphan Notes

Notes nothing links to. For each per-instance note (Plan, Design, Improvement, Code Review, Ship Report, Context Refresh, module deep notes), check that at least one other note wikilinks it.

VAULT="${CONDUCTY_VAULT:-$HOME/Obsidian/Conducty}"
for f in "$VAULT"/Plans/Plan*.md "$VAULT"/Designs/Design*.md \
         "$VAULT"/Improvements/Improvement*.md \
         "$VAULT"/"Code Reviews"/"Code Review"*.md \
         "$VAULT"/"Ship Reports"/"Ship Report"*.md; do
    [ -f "$f" ] || continue
    base="$(basename "$f" .md)"
    if ! grep -rl --exclude="$base.md" "\\[\\[$base\\]\\]" "$VAULT" > /dev/null; then
        echo "ORPHAN: $base"
    fi
done

Indexes are expected to link orphans. If a per-instance note isn't in its index, that is the bug — fix the index.

Audit 2: Broken Wikilinks

Wikilinks pointing at notes that don't exist. Extract every [[Target]] from every vault note, check the target file exists.

# Wikilinks resolve by basename anywhere in the vault, so search recursively.
grep -rho '\[\[[^]]*\]\]' "$VAULT" --include='*.md' | \
  sed 's/\[\[//;s/\]\]//' | sort -u | \
  while read -r target; do
    # Strip alias suffix: [[Note|Display]] → Note
    target="${target%%|*}"
    if ! find "$VAULT" -type f -name "$target.md" -print -quit | grep -q .; then
      echo "BROKEN: [[$target]]"
    fi
  done