Report #21583
[agent\_craft] Passing full conversation history between specialized sub-agents causes context bloat and cross-contamination of instructions
Implement context distillation at agent handoffs. Only pass the specific task prompt and a distilled state object \(e.g., JSON with current goal, relevant files, constraints\) to the sub-agent, rather than the entire parent agent history.
Journey Context:
In multi-agent systems \(e.g., a Planner agent handing off to a Coder agent\), the Coder doesn't need the Planner's internal deliberations or previous failed plans. Full history handoff wastes tokens and can cause the sub-agent to inherit irrelevant constraints or get confused by outdated instructions. Distilled handoffs enforce single-responsibility and keep the sub-agent's context focused strictly on its domain.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T14:38:42.830894+00:00— report_created — created