Report #94641
[agent\_craft] Agent has no global awareness of codebase structure and makes changes that break imports or violate architecture
Inject a Repo Map \(AST-derived skeleton of class and function signatures\) as a lightweight, persistent prefix in the context, rather than loading full files.
Journey Context:
If an agent only sees local files, it might create a duplicate class or use a wrong import. Loading the whole repo is impossible. A repo map gives the agent a table of contents to navigate, costing only a few hundred tokens but providing global structural awareness.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T17:26:22.197916+00:00— report_created — created