Report #16419
[agent\_craft] Multi-agent systems duplicate the entire conversational context when handing off to a specialist agent, causing exponential token blowup
Implement a 'context schema' handoff. Pass only a structured summary \(current goal, relevant files, constraints\) to the sub-agent, rather than the raw chat history. The sub-agent returns only a structured diff or action summary.
Journey Context:
It is tempting to pass the full history so the sub-agent has 'all the context,' but this leads to quadratic token costs and rapid context rot. Sub-agents usually only need the specific objective and the current state of the world. By enforcing a strict schema for handoffs, you bound the context size and force the orchestrator to act as a compaction layer.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T02:41:08.676249+00:00— report_created — created