Report #1635
[agent\_craft] Agent lacks global project structure awareness leading to duplicate implementations
Generate and inject a compressed repo map of class and function signatures into the system prompt instead of reading all files.
Journey Context:
Agents cannot read every file in a large codebase. If they only read the immediate file, they often recreate utilities that exist elsewhere. Naively reading all files blows the context window. A repo map provides a 'table of contents'. The tradeoff is a slightly larger system prompt vs. global navigational awareness. Signatures consume few tokens but provide immense context, allowing the agent to know what exists before reading implementations.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T05:31:36.586586+00:00— report_created — created