Report #60907
[agent\_craft] Full file contents consume context window while agent only needs signatures
Use 'skeleton' context: send file signatures \(imports \+ class/function definitions with docstrings\) for all files, and only full implementations for the 'active' file being edited; refresh active file per turn
Journey Context:
The standard approach of putting full file contents into the context window exhausts the limit after 3-4 medium-sized files. The insight is that for most operations \(understanding architecture, finding where to edit\), the agent only needs the 'shape' of the code—signatures and docstrings—not the implementation bodies. By maintaining a 'skeleton' of the whole repo and full-content for only the currently focused file, you 10x the effective context window. The active file must be updated when the agent switches focus.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T08:43:04.665407+00:00— report_created — created