Search Interceptor

Search Interceptor

This skill helps optimize bulk file operations by suggesting semantic search alternatives when they would be more efficient.

When Semantic Search is More Efficient

When to Consider Alternatives

Multiple File Reads

If planning to read several files, consider:

bashCopy code
# Instead of reading 5 files individually
claudemem search "concept from those files" -n 15
# Gets ranked results with context

Broad Glob Patterns

If using patterns like src/**/*.ts:

bashCopy code
# Instead of globbing and reading all matches
claudemem --agent map "what you're looking for"
# Gets structural overview with PageRank ranking

File Paths Mentioned in Task

Even when specific paths are mentioned, semantic search often finds additional relevant code:

bashCopy code
claudemem search "concept related to mentioned files"

Interception Protocol

Step 1: Pause Before Execution

When you're about to execute bulk file operations, STOP and run:

bashCopy code
claudemem status

Step 2: Evaluate

If claudemem is indexed:

If claudemem is NOT indexed:

bashCopy code
claudemem index -y

Then proceed with semantic search.

Step 3: Execute Better Alternative

bashCopy code
# Instead of reading N files, run ONE semantic query
claudemem search "concept describing what you need" -n 15

# ONLY THEN read specific lines from results

Interception Decision Matrix

Examples of Interception

Example 1: Auth Investigation

❌ Original plan:

Copy code
I see the task mentions auth, let me read:
- src/services/auth/login.ts
- src/services/auth/session.ts
- src/services/auth/jwt.ts
- src/services/auth/middleware.ts
- src/services/auth/utils.ts

✅ After interception:

bashCopy code
claudemem status  # Check if indexed
claudemem search "authentication login session JWT token validation" -n 15
# Now I have ranked, relevant chunks instead of 5 full files

Example 2: API Integration Audit

❌ Original plan:

Copy code
Audit mentions Prime API files:
- src/services/prime/internal_api/client.ts
- src/services/prime/api.ts
Let me just Read these directly...

✅ After interception:

bashCopy code
claudemem search "Prime API integration endpoints HTTP client" -n 20
# This finds ALL Prime-related code, ranked by relevance
# Not just the 2 files mentioned

Example 3: Pattern Discovery

❌ Original plan:

Copy code
Glob("src/**/*.controller.ts")
Then read all 15 controllers to understand routing

✅ After interception:

bashCopy code
claudemem search "HTTP controller endpoint route handler" -n 20
# Gets the most relevant routing code, not all controllers

Why Semantic Search Often Works Better

Tip: For investigation tasks, try claudemem search first to get a ranked view of relevant code.

Integration with Other Skills

This skill works with:

Hook System Integration

The hook system may provide claudemem results proactively when the index is available:

• Grep queries → May receive claudemem search results instead
• Bulk reads → May receive suggestion to use semantic search
• Broad globs → May receive map results

Using the Bypass Flag

When you specifically need native tool behavior:

jsonCopy code
{ "pattern": "exact string", "_bypass_claudemem": true }

This tells hooks you intentionally want native tool output.

Quick Reference

Before bulk Read/Glob operations, consider:

1. Is claudemem indexed? → claudemem status
2. Can this be one semantic query? → Often yes
3. Do you need exact matches? → Use native tools with bypass flag

General guideline: For understanding/investigation, try semantic search first. For exact matches, use native tools.

Maintained by: MadAppGang Plugin: code-analysis v2.16.0 Purpose: Help optimize bulk file operations with semantic search alternatives