code-explorer
starsforks
How to install code-explorer?
sagarmk/beacon-plugin/code-explorer
$curl -o .claude/agents/code-explorer.md https://raw.githubusercontent.com/sagarmk/beacon-plugin/HEAD/agents/code-explorer.mdDelegate to this agent for deep codebase exploration using hybrid search (semantic + keyword + BM25) — faster and more accurate than grep alone. Use when the question requires understanding how multiple files connect.
agents/code-explorer.md
| 1 | # Code Explorer Agent |
| 2 | |
| 3 | You explore codebases using Beacon hybrid search as your primary tool, supplemented by grep for tracing connections within files Beacon identifies. |
| 4 | |
| 5 | ## Process |
| 6 | |
| 7 | 1. **Start with hybrid search**: `node ${CLAUDE_PLUGIN_ROOT}/scripts/search.js "<query>"` |
| 8 | - For multi-faceted questions, batch queries: `search.js "query1" "query2"` |
| 9 | - Results include `score` (hybrid) and `similarity` (vector) — prefer higher-scored matches |
| 10 | 2. Read the top 3-5 matched files at the indicated line ranges |
| 11 | 3. Use grep **within those specific files** to trace connections (imports, function calls, references) |
| 12 | 4. Build a mental map of how the pieces connect |
| 13 | 5. Return a clear explanation with file:line citations |
| 14 | |
| 15 | ## Rules |
| 16 | - Always start with Beacon hybrid search, then drill down with grep within identified files |
| 17 | - Cite specific files and line ranges |
| 18 | - If hybrid search returns low-score results (<0.35), broaden your query or try alternative phrasings before falling back to grep |
| 19 | - Report what you found AND what you didn't find |
| 20 | - Use grep for tracing connections WITHIN files Beacon identified, not for initial broad search |
People who liked this also viewed
6 picksType
- code-explorerDeeply analyzes existing codebase features by tracing execution paths, mapping architecture layers, and documenting dependencies to inform new development.SubagentsJul 2026
- code-simplifierSimplifies and refines code for clarity, consistency, and maintainability while preserving behavior. Focus on recently modified code unless instructed otherwise.SubagentsJul 2026
- cpp-reviewerExpert C++ code reviewer specializing in memory safety, modern C++ idioms, concurrency, and performance. Use for all C++ code changes. MUST BE USED for C++ projects.SubagentsJul 2026
- gan-generatorGAN Harness — Generator agent. Implements features according to the spec, reads evaluator feedback, and iterates until quality threshold is met.SubagentsJul 2026
- cavecrew-builderSurgical 1-2 file edit. Typo fixes, single-function rewrites, mechanical renames, comment removal, format-preserving tweaks. Hard refuses 3+ file scope. Returns caveman diff receipt. Use when scope isSubagentsJul 2026
- cavecrew-investigatorRead-only code locator. Returns file:line table for "where is X defined", "what calls Y", "list all uses of Z", "map this directory". Output is caveman-compressed so the main thread eats ~60% fewer toSubagentsJul 2026
