Vault — Living Knowledge Base v3.0

Karpathy-inspired knowledge pipeline: Ingest -> Compile -> Query.

Architecture

The vault is a PRIVATE directory OUTSIDE the public repo:

• Location: $HOME/Documents/Obsidian/MiVault/ (configurable)
• Backup: private git repo (user creates their own)
• Viewer: Obsidian (optional, vault works as plain markdown + git)

This skill teaches HOW to use the vault (framework). It does NOT contain vault data.

Actions

/vault init

Create vault structure:

VAULT_DIR="${VAULT_DIR:-$HOME/Documents/Obsidian/MiVault}"

# 3-layer structure
mkdir -p "$VAULT_DIR"/{global/{raw/articles,raw/papers,raw/images,wiki,output,decisions},projects,_templates}

# Create vault index
echo "# Vault Index" > "$VAULT_DIR/_vault-index.md"
echo "# Project Index" > "$VAULT_DIR/projects/_project-index.md"

Or run: scripts/setup-obsidian-vault.sh

/vault save <classification> <content>

Save a learning to the vault:

/vault search <query>

Search vault for relevant knowledge:

1. Search in: global/wiki/ + projects/{current-project}/
2. NEVER search in: projects/{other-project}/ (isolation)
3. Return: matching articles with relevance score

/vault index

Update all _index.md files in the vault:

1. Scan all .md files in global/wiki/ and projects/*/wiki/
2. Regenerate _vault-index.md and projects/_project-index.md
3. Update backlinks between articles

/vault compile

Compile raw notes into wiki articles (Karpathy pipeline):

1. Read raw/ and lessons/ directories
2. LLM compiles new articles in wiki/
3. Update backlinks between articles
4. Update _index.md
5. Knowledge Graduation: promote high-confidence learnings to .claude/rules/learned/

Graduation criteria:

• Confidence >= 0.7
• Confirmed in >= 3 sessions
• Format: rule text + source + confidence + last confirmed date

/vault demote <rule>

Revert a graduated rule back to vault if incorrect:

1. Remove from .claude/rules/learned/{category}.md
2. Mark source article with status: demoted

Integration Points

Project Isolation

1. A project ONLY reads: global/wiki/ + projects/{its-own-name}/
2. NEVER reads projects/{other-project}/ directly
3. GREEN learnings from any project can be promoted to global/wiki/
4. SHA-256 deduplication prevents duplicate entries

Anti-Rationalization