Files
Claude-Code-Workflow/.claude/workflows/context-requirements.md
catlog22 474a1ce027 fix: Correct Exa MCP tool call syntax in context-requirements
- Change exa() to mcp__exa__search() for correct MCP invocation
- Add complete parameter documentation (query, numResults, livecrawl)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-17 22:25:50 +08:00

2.0 KiB

Context Requirements

Before implementation, always:

  • Identify 3+ existing similar patterns
  • Map dependencies and integration points
  • Understand testing framework and coding conventions

MCP Tools Usage

smart_search - Code Search (REQUIRED)

When: Find code, understand codebase structure, locate implementations

How:

smart_search(query="authentication logic")           // Auto mode (recommended)
smart_search(action="init", path=".")                // First-time setup
smart_search(query="LoginUser", mode="exact")        // Precise matching
smart_search(query="import", mode="ripgrep")         // Fast, no index

Modes: auto (intelligent routing), hybrid (best quality), exact (FTS), ripgrep (fast)


read_file - Read File Contents

When: Read files found by smart_search

How:

read_file(path="/path/to/file.ts")                   // Single file
read_file(path="/src/**/*.config.ts")                // Pattern matching

edit_file - Modify Files

When: Built-in Edit tool fails or need advanced features

How:

edit_file(path="/file.ts", old_string="...", new_string="...", mode="update")
edit_file(path="/file.ts", line=10, content="...", mode="insert_after")

Modes: update (replace text), insert_after, insert_before, delete_line


write_file - Create/Overwrite Files

When: Create new files or completely replace content

How:

write_file(path="/new-file.ts", content="...")

When: Find documentation/examples outside codebase

How:

mcp__exa__search(query="React hooks 2025 documentation")
mcp__exa__search(query="FastAPI auth example", numResults=10)
mcp__exa__search(query="latest API docs", livecrawl="always")

Parameters:

  • query (required): Search query string
  • numResults (optional): Number of results to return (default: 5)
  • livecrawl (optional): "always" or "fallback" for live crawling