Report #25314
[synthesis] LLMs lose context in large codebases and make edits that break dependencies because they can't see the whole project
Generate a 'repo map' \(a tree-sitter based summary of definitions and references\) and include it in the context, rather than trying to stuff entire files into the prompt.
Journey Context:
You can't fit a whole repo into the context window. Aider uses tree-sitter to parse the repo and create a compact map of classes, functions, and their locations. This gives the LLM a 'table of contents' so it knows where to look. When it needs to make an edit, it can request the specific file content. This is a crucial architectural pattern for coding agents: summarize globally, read locally.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T20:53:43.426169+00:00— report_created — created