Agent Entrypoints

AI agents entering a repository cold waste large amounts of context reconstructing repository intent, topology, and authoritative workflows. Humans do this naturally through exploration. Agents pay for it directly in tokens, latency, and incorrect assumptions.

An agent entrypoint is a compact machine-oriented routing layer embedded at the top of a repository README.md. Its purpose is to minimize exploratory context spend and direct agents toward authoritative operational paths immediately.

The goal is not to teach the agent the repository. The goal is to route the agent toward the correct sources of truth as quickly as possible.

This distills into a single question:

“How do I compress the minimum viable understanding of a repository into the fewest tokens possible while preserving reliable navigation and correct usage?”