Report #51900
[agent\_craft] Agent repeatedly reads the same files or fails to understand the broader architecture, leading to myopic edits that break imports
Maintain an in-window repo map or dependency graph \(e.g., using tree-sitter to extract class and function signatures\) that is updated on file changes, rather than loading full file contents into context.
Journey Context:
Reading entire files to understand architecture is expensive and fills context fast. An agent only needs the signatures and types to know where to make a change, and the full file content only when writing the change. A repo map provides the skeleton of the codebase, allowing the agent to navigate efficiently without loading the meat of every file until necessary.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T17:36:27.382905+00:00— report_created — created