memory-search

Imported from ruvnet/ruflo (plugins/ruflo-rag-memory/skills/memory-search/SKILL.md) via skills.sh. Install upstream with npx skills add ruvnet/ruflo --skill memory-search. Copyright stays with the author.

Memory Search

Search Ruflo's stored memories. Select a strategy supported by the Ruflo CLI or MCP tool, and report which one actually ran.

Strategy selection

• Default: semantic retrieval through memory search or MCP memory_search.
• --hybrid: CLI keyword + semantic result union, deduplicated and sorted by score. This is not the ruvector search CLI and does not claim Graph RAG or sparse/dense RRF.
• --smart: request query expansion, RRF across variants, recency weighting, and MMR diversity. The MCP tool can fall back to plain search if the installed memory package lacks smartSearch; inspect the returned fallback note before claiming SmartRetrieval ran.
• Cross-namespace: MCP memory_search_unified merges and deduplicates results from multiple namespaces.

If the user requests --graph-rag, explain that this plugin has no supported text-query Graph RAG command. Offer --smart semantic retrieval as a clearly labeled fallback; do not claim graph traversal.

Steps

1. Parse the query, optional namespace, result limit, and strategy flags. Omit --namespace to search all namespaces. For CLI commands, treat the query as untrusted shell input: use POSIX single-quote escaping for embedded apostrophes and reject embedded newlines. Do not interpolate it inside double quotes.

2. Run one of the supported paths:

   Semantic (default)

   npx @claude-flow/cli@latest memory search --query 'QUERY' --limit 10

   MCP: mcp__plugin_ruflo-core_ruflo__memory_search({ query: "QUERY", limit: 10 })

   Keyword + semantic union (--hybrid)

   npx @claude-flow/cli@latest memory search --query 'QUERY' --type hybrid --limit 10

   Add --namespace NAMESPACE only when the user requests one.

   Smart retrieval (--smart)

   npx @claude-flow/cli@latest memory search --query 'QUERY' --smart --limit 10

   MCP: mcp__plugin_ruflo-core_ruflo__memory_search({ query: "QUERY", smart: true, limit: 10 })

   Cross-namespace bridge search mcp__plugin_ruflo-core_ruflo__memory_search_unified({ query: "QUERY", limit: 10 })

3. For a complex query, optionally request AgentDB context synthesis with its registered schema: mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesize({ query: "QUERY", maxEntries: 10 })

4. Present the returned entries with namespace attribution. Distinguish raw similarity from SmartRetrieval's rankingScore; neither is a probability of truth. State when SmartRetrieval fell back to plain search.

Namespace guide