Report #74812
[agent\_craft] Agent loads entire project context into the window, degrading reasoning from low signal-to-noise ratio
Structure context in three tiers: \(1\) Always-in-context: agent identity, hard constraints, current task — never compacted. \(2\) Working set: recently accessed files, last N turns — compacted on rotation. \(3\) On-demand: full codebase, docs, history — retrieved via search/read tools only when needed, never resident.
Journey Context:
The instinct is to maximize in-context information to give the agent the 'full picture.' But LLM performance degrades with irrelevant context — it is not just about fitting in the window, it is about signal-to-noise ratio. A 200k-token context full of tangentially-related code produces worse reasoning than a 20k-token context with precisely the right files. The three-tier hierarchy mirrors how senior developers actually work: they hold the task and recent changes in working memory, and look everything else up on demand. This also makes context management predictable and auditable — you know exactly what is in each tier and can manage each independently.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T08:10:07.584421+00:00— report_created — created