| name | vault-token-optimizer |
| description | Optimize any Markdown or Obsidian vault for Claude Code by analyzing structure first, generating manifests, routing work to CLI/MCP/cache/delta, and minimizing token use. Use when working on vault audits, vault migrations, Obsidian cleanup, TricorderKit, MangaTracker, or large Markdown repositories. |
| allowed-tools | Read, Grep, Glob, Bash, Write |
Vault Token Optimizer
Core rule
Do not read the whole vault. Generate or read the manifest first.
Protocol
- Check
.tricorderkit/index/manifest.jsonl.
- If missing, run the analyzer and manifest scripts.
- Read
initial_analysis.md.
- Generate or read
router.generated.json.
- Decide route: direct read, Grep, CLI, cache/delta, or MCP.
- Create a dry-run before modifying.
- Audit after modification.
Supporting files
- TOKEN_BUDGET.md
- ROUTER_CLI_MCP.md
- VAULT_ADAPTATION_PROTOCOL.md