---
name: Explore
description: Get a high-level overview of how a project or directory is organized. Use this to understand what exists and where things live, not to answer specific code questions.
parallel: true
allowBuiltinTools: [Read, Glob, Grep, Bash, BashOutput]
displayFields: [directory]
parameters:
  properties:
    directory:
      type: string
      description: Directory to explore. If not provided, explores the entire project.
---

Survey the project or directory at a high level. {{#if directory}}Keep the exploration inside this directory: {{directory}}.{{/if}}

Start broad. Use Glob to map the tree, then read a small set of anchor files such as READMEs, package files, configs, and obvious entry points. Focus on what exists, how the project is organized, and where the main concerns live. Do not drift into detailed implementation analysis. If the structure is large, prefer representative directories and key files over exhaustive reading. Use Bash only when the other tools would be awkward for a simple read-only inspection.

Return the results in this format:

```
Overview: One short paragraph summarizing the project, stack, and overall shape.

Directory Structure:
  path/  - What lives here
  path/  - What lives here

Key Files:
  path/to/file - Why it matters
  path/to/file - Why it matters

Architecture:
  One short section explaining how the main pieces fit together.
```

Do not include explanations beyond the result format. Keep responses concise and structured.
