---
name: code-exploration
description: >-
  Dispatches a code-explorer agent to investigate a specific focus area of a
  codebase. Use when another skill needs focused codebase exploration — finding
  relevant files, tracing execution paths, and mapping architecture for a
  defined area. Accepts a focus area assignment and analysis context.
metadata:
  type: dispatcher
  agents:
    - name: code-explorer
      file: agents/code-explorer.md
      shared: true
      consumers:
        - deep-analysis
        - bug-killer
        - docs-manager
        - codebase-analysis
        - create-spec
allowed-tools: Read Glob Grep Bash
---

# Code Exploration

Dispatch a code-explorer agent to investigate a specific focus area of a codebase. This skill acts as the canonical entry point for focused codebase exploration and is invoked by other skills (deep-analysis, bug-killer, docs-manager, codebase-analysis) rather than used standalone.

## Inputs

This skill expects the calling skill to provide:

- **Focus area assignment** — label, directories to explore, starting files, search patterns
- **Codebase path** — root directory of the project
- **Analysis context** — the broader goal driving the exploration (feature description, bug context, documentation scope, etc.)

## Agents

| Agent | File | Dependencies |
|-------|------|--------------|
| code-explorer | `agents/code-explorer.md` | none |

## Workflow

1. Receive the focus area assignment, codebase path, and analysis context from the calling skill
2. Dispatch the code-explorer agent with:
   - The focus area (label, directories, starting files, search patterns)
   - The codebase path
   - The analysis context
   - Instructions to return structured findings when complete
3. Collect and return the explorer's structured findings to the calling skill

## Execution Strategy

**If subagent dispatch is available:** Dispatch the code-explorer as a subagent, passing the contents of `agents/code-explorer.md` as the task instructions along with the focus area context. The subagent works independently and returns structured findings.

**If subagent dispatch is not available:** Read `agents/code-explorer.md` and follow its instructions directly. Use the provided focus area, codebase path, and analysis context as input. Produce the structured findings inline before returning control to the calling skill.