Report #95899
[agent\_craft] Agent loads entire repositories into context, hitting token limits and confusing the LLM with boilerplate, instead of navigating the codebase surgically
Use a repository map \(AST-based summary of classes, functions, and signatures\) for navigation, and only load the full source of specific functions or files the agent decides to edit.
Journey Context:
Giving an agent grep or cat over a whole repo is inefficient. The agent wastes context on imports, boilerplate, and unrelated logic. Tools that generate a compact outline of the codebase using tree-sitter ASTs allow the agent to understand the architecture and locate the exact symbols it needs, then read only the specific code blocks required. This drastically reduces context usage and keeps the agent focused on the logic that matters.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T19:32:49.782370+00:00— report_created — created