# Codebase exploration

Answer a specific repository question by tracing entry points, calls, state changes, and relevant tests. The explanation connects verified facts to their source locations and makes unresolved links explicit.

Package version: 0.1.0-beta.7.

Included with [Faye Coding Assistant](/plugins/faye-coding-assistant/).

## When to use

Use this when the deliverable is a repository map, behavior trace, explanation, or impact analysis before a change.

## What to provide

- The repository and the question you need answered.
- A feature, symbol, route, configuration key, or directory that can bound the investigation.

## Expected results

- A concise map of responsibilities and execution or data flow.
- Source evidence, relevant constraints, and clearly identified unknowns.

## Example requests

### Try this request

#### Codex

```
$codebase-exploration Trace how a plugin manifest becomes a website detail page. Identify the input files, generated outputs, and the code that owns the page URL.
```

#### Grok

```
/codebase-exploration Trace how a plugin manifest becomes a website detail page. Identify the input files, generated outputs, and the code that owns the page URL.
```

#### Antigravity

```
/codebase-exploration Trace how a plugin manifest becomes a website detail page. Identify the input files, generated outputs, and the code that owns the page URL.
```

## Requirements

- Read access to the relevant repository and project instructions.

## Scope and limitations

- The workflow remains read-only and avoids commands that generate builds, dependencies, or caches.
- It does not add an unsolicited implementation plan.
- Repository reading that merely supports another task stays within that task.

## Related guides and supporting files

- [Read-only coding analyst](/agents/faye-coding-assistant/faye-coding-analyst/) — Defines a bounded analysis role for exploration, diagnosis, review, planning, suite assessment, and handoff.
- [Faye Coding Assistant](/plugins/faye-coding-assistant/) — Understand repositories, plan and implement changes, diagnose failures, and review code with clear evidence.

## Technical source

[Open original source](/marketplace/plugins/faye-coding-assistant/skills/codebase-exploration/SKILL.md)

Source path: plugins/faye-coding-assistant/skills/codebase-exploration