soleri-vault-navigator

name	soleri-vault-navigator
tier	default
description	Triggers: "search the vault", "find patterns for", "have we seen this before", "vault search", "best practice for". Queries knowledge base for existing solutions and prior art.

Vault Navigator — Knowledge Oracle

Navigate the vault intelligently. Picks the right search strategy based on what the user needs.

Search Strategy Decision Tree

"Have we seen this?" / "Best practice for X"

YOUR_AGENT_core op:search_intelligent
  params: { query: "<question>" }

If results are weak, fall back to op:search with explicit filters (type, category, tags, severity).

"Show me everything about X" (Exploration)

YOUR_AGENT_core op:vault_tags
YOUR_AGENT_core op:vault_domains
YOUR_AGENT_core op:vault_recent

"What's stale?" / "What needs updating?"

YOUR_AGENT_core op:vault_age_report

"What do other projects do?"

YOUR_AGENT_core op:memory_cross_project_search
  params: { query: "<topic>", projectPath: "." }
YOUR_AGENT_core op:project_linked_projects

"Has brain learned about X?"

YOUR_AGENT_core op:brain_strengths
YOUR_AGENT_core op:brain_global_patterns
  params: { domain: "<domain>" }

Session Memory Search

For queries about recent work or session-specific knowledge:

YOUR_AGENT_core op:memory_search
  params: { query: "<session-specific query>" }

Broad exploration ("What do I know about X?")

Chain: search_intelligent -> vault_tags / vault_domains -> memory_cross_project_search -> brain_strengths. Label each finding with its source.

Presenting Results

Always include: Source (vault/memory/brain), Confidence (score), Relevance (why it matches), Next step (how to apply).

Fallback: Web Search

If all vault strategies return nothing, search the web. If web finds something useful, offer to capture: op:capture_quick.

Common Mistakes

• Using only one search strategy instead of trying multiple
• Not labeling result sources (user can't judge confidence)
• Saying "nothing found" without trying web search fallback

Quick Reference

Op	When to Use
search_intelligent	Default semantic search
search	Structured search with filters
vault_tags / vault_domains	Browse knowledge landscape
vault_recent	Recently modified entries
vault_age_report	Stale entries
memory_cross_project_search	Cross-project search
memory_search	Session and recent work search
brain_strengths / brain_global_patterns	Proven patterns
capture_quick	Capture web findings