Source Search

When to Use

• You need to locate where a symbol, string, env var, or error code is defined or referenced across the codebase.

Rules

• Read-only: do not modify files.

• Prefer grep for broad discovery, then targeted read for the best matches.

• Narrow with glob patterns to reduce noise.

Workflow

• Identify exact search keys and likely variants.

• Glob by folder or pattern to limit scope.

• Grep and rank results by relevance.

• Return top matches with path:line and a short note.

Output

• Definitions and top usages with path:line citations.

• Brief note on next steps or likely primary file to inspect.

Examples

• "Where is PrefixJtiBlacklist defined?" - search config/ for the constant.

• "Which files reference ACTIVATE_JWT ?" - grep across config/ , setTestEnv.sh , .env.sample .

Related Skills

• code-navigation (impact mapping), file-reader (detailed read)