atlas_where
Read-onlyIdempotent
Finds the best-matching documentation section for a topic and returns a compact pointer with path and line, without loading full text. Use it to answer where a topic is documented.
Instructions
Locate the best-matching documentation section for a topic and return its pointer (~60 tokens) without full text.
Use this tool FIRST for 'where is X documented?', 'which file covers Y?', or 'which section defines Z?'.
Follow up with `atlas_read(anchor)` only if you need the section body, or fall back to `atlas_search`
if you need multiple ranked snippets across documents.
Behavior & Output:
- Read-only, deterministic BM25 lookup against the local SQLite FTS5 index (auto-refreshed before query).
- Returns a JSON string with `{found: true, anchor, heading, path, line, alternatives}` when matched,
or `{found: false, hint}` when no section matches.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | Natural-language question or topic keywords to locate in the project documentation (e.g. 'damage model', 'Where is dialogue branching described?'). Supports English and German terms with automatic stop-word removal and umlaut folding. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |