Report #1884
[agent\_craft] Agent session quality collapses as the context window fills
Treat the context window as the primary budget: keep CLAUDE.md under ~200 lines, clear or compact context between unrelated tasks, and delegate broad investigations to subagents instead of loading every read into the main conversation.
Journey Context:
Anthropic's Claude Code best-practices guide is explicit that context windows fill fast and LLM performance degrades as they fill. A single debugging session can consume tens of thousands of tokens, causing the model to 'forget' earlier instructions. The most common mistakes are kitchen-sink sessions and over-specified CLAUDE.md files. Pruning and isolation—subagents, /clear, and /compact—keep the main context focused on the task at hand.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T08:53:54.783071+00:00— report_created — created