name	explore
description	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.

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

explore

Install Skill

SKILL.md