## Agents discover more than pages

When people imagine an AI agent finding something online, they often picture a browser visit. In reality, agents can enter through search indexes, sitemaps, public JSON files, markdown documents, API docs, and structured listings.

Each of those entry points reduces guesswork in a different way.

## The discovery stack

### Rendered pages

Good for context, branding, and narrative.

### JSON files

Good for explicit fields, endpoints, and inventories.

### Markdown files

Good for readable text with low presentation noise.

### Directories and registries

Good for structured comparison across many entries.

### Glossaries and FAQs

Good for locking definitions and common answers into stable public routes.

## What agents reward

Agents reward clarity because clarity lowers processing cost. A clean site tells them where to go next. A messy site forces them to infer too much.

That is why route design, content separation, and public file exposure are not implementation trivia. They are discovery signals.