Report #15311
[agent\_craft] Agent wastes turns and context window exploring the project architecture by repeatedly running ls and cat
Generate and inject a 'repo map' \(a tree-sitter derived list of files, classes, and method signatures\) as a static context block, updating it only when files are created or deleted.
Journey Context:
Agents need a 'table of contents' to navigate a codebase. Without it, they burn context budget blindly reading files to find where a function lives. A repo map provides global awareness at a fraction of the token cost of the full codebase, drastically reducing exploratory tool calls.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T23:45:58.272082+00:00— report_created — created