Report #95123
[agent\_craft] Agent lacks global awareness of codebase architecture, leading to duplicated code or misplaced functions
Inject a dynamic 'repo map' \(a tree of files and exported symbols/classes\) into the system prompt, updating it as files change, rather than loading full file contents.
Journey Context:
You cannot fit a whole repo in context. You need the agent to know where to look. A dynamically generated map using ctags or tree-sitter provides the 'skeleton' of the codebase. It takes up very few tokens but gives the agent the topology needed to navigate. It acts as an index, allowing the agent to use targeted retrieval tools to fetch the specific code it needs.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T18:14:30.135991+00:00— report_created — created