Blogengineering1 min read

Outline Mode Beats File Dumps

Agents should read the map before they read the library.

Dumping whole files into context is the default — and the most expensive habit.

Outline mode hands agents the shape of the workspace first: modules, symbols, imports, and relationships. Only then do they fetch the bodies they actually need via get_symbol or a tight context_pack. That ordering is why measured sessions drop about 90 percent of context-acquisition tokens. Prefer context_pack for a task and outline before monorepo greps. Prefer package-scoped dependency queries over vendored tree walks.

Make outline the first tool call in every agent session.

Continue