explore

Mburdo's avatarfrom Mburdo

Parallel codebase search with Warp-Grep MCP. Use for codebase discovery, understanding how things work, data flow analysis, or when the user asks "how does X work" about the codebase.

⭐42stars🔀5forks📁View on GitHub🕐Updated Dec 28, 2025

When & Why to Use This Skill

The 'explore' Claude skill is a high-performance codebase discovery tool powered by the Warp-Grep MCP. It enables developers to perform up to eight parallel searches simultaneously to map out complex system architectures, analyze cross-file data flows, and gain a deep understanding of how specific features are implemented across a repository. It is specifically designed to bridge the gap between simple keyword searching and high-level structural comprehension.

Use Cases

  • Architectural Mapping: Quickly identify how different modules interact and visualize the structural hierarchy of a new or large-scale codebase.
  • Data Flow Analysis: Trace the path of data from input to output across multiple files to understand complex logic and state management.
  • Developer Onboarding: Accelerate the learning curve for new team members by providing instant, context-aware answers to 'how does X work' questions.
  • Cross-Cutting Concern Audits: Efficiently locate and analyze implementation patterns that span the entire project, such as authentication, logging, or error handling strategies.
  • Impact Analysis: Before making changes, use parallel search to discover all related dependencies and potential side effects of modifying a specific component.
nameexplore
descriptionParallel codebase search with Warp-Grep MCP. Use for codebase discovery, understanding how things work, data flow analysis, or when the user asks "how does X work" about the codebase.

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:

  1. Interprets your question
  2. Runs up to 8 parallel searches
  3. 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 patterns
  • Grep tool — Specific pattern search
  • Glob tool — File pattern matching