tomevault-io Explore — Codebase Discovery
Parallel codebase search. Runs 8 searches per turn for efficient discovery. Direct execution.
Design rationale: This skill executes directly as a simple MCP call, not substantial analytical work. The Warp-Grep MCP handles the complexity internally.
When This Applies
| Signal | Action |
|---|---|
| "How does X work?" | Use /explore |
| Data flow across files | Use /explore |
| Cross-cutting concerns | Use /explore |
| Understanding architecture | Use /explore |
| User says "/explore" | Run discovery |
How It Works
Warp-Grep is an MCP tool that activates automatically for natural language code questions. It:
- Interprets your question
- Runs up to 8 parallel searches
- Returns relevant code snippets with context
Tool Reference
The Warp-Grep MCP provides these capabilities:
| Capability | Description |
|---|---|
| Parallel search | Up to 8 searches per turn |
| Context-aware | Returns surrounding code |
| Natural language | Understands questions |
| Cross-file | Follows data flow |
Query Patterns
Good Queries
"How does the payment processing flow work?"
"Where are user sessions managed?"
"How is error handling done in the API layer?"
"What happens when a request comes in?"
"How do modules communicate?"
"What's the data flow for authentication?"
Less Effective Queries
| Query | Problem | Better Tool |
|---|---|---|
| "Find function X" | Too specific | Grep or rg |
| "Open file Y" | Not a search | Read tool |
| "Does X exist?" | Simple check | Glob |
When to Use /explore
| Use Case | Use /explore? |
|---|---|
| "How does authentication work?" | YES |
| Data flow analysis | YES |
| Understanding module interactions | YES |
| Finding all usages of a pattern | YES |
| Cross-cutting concern analysis | YES |
| Architecture understanding | YES |
When NOT to Use /explore
| Use Case | Use Instead |
|---|---|
| Known function name | Grep tool |
| Known exact file | Read tool |
| Simple existence check | Glob tool |
| Single specific search | Grep tool |
| External API docs | /ground |
| Past session content | /recall |
Integration with Workflow
During /prime
Use /explore to understand project structure
During /advance
Use /explore to understand code you'll modify
When stuck
Use /explore to find related implementations
Decision Tree
What are you looking for?
UNDERSTANDING ──► /explore (this skill)
"How does X work?"
"What's the flow for Y?"
SPECIFIC CODE ──► Grep tool
"Find usages of functionX"
FILE PATHS ─────► Glob tool
"Find all *.ts files"
READ FILE ──────► Read tool
"Show me src/auth.ts"
EXTERNAL ───────► /ground
"Current API for library X"
HISTORY ────────► /recall
"How did we do this before?"
Requirements
Requires Morph API key configured:
claude mcp add morph-fast-tools -s user \
-e MORPH_API_KEY=your-key \
-e ALL_TOOLS=true \
-- npx -y @morphllm/morphmcp
Quick Reference
Use for:
- Architecture understanding
- Data flow analysis
- Cross-cutting concerns
- Module interactions
- "How does X work?"
Don't use for:
- Specific function lookup → Grep
- Known file path → Read
- External APIs → /ground
- Past sessions → /recall
See Also
/ground— External documentation search/recall— Past session patternsGreptool — Specific pattern searchGlobtool — File pattern matching
Converted and distributed by TomeVault — claim your Tome and manage your conversions.