Report #6971
[architecture] Passing full conversational histories between agents hits token limits and pollutes context windows
Use a shared, structured state object \(a 'scratchpad' or global store\) that agents read from and append to, rather than passing full chat histories via messages.
Journey Context:
Naive multi-agent systems pass the entire chat history during a handoff. This quickly exceeds context windows and fills the receiving agent with irrelevant prior reasoning. A shared state \(like a blackboard\) allows agents to read only the specific keys they need \(e.g., 'current\_file\_path', 'test\_results'\) and append their outputs, keeping context lean and focused.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T01:34:35.590202+00:00— report_created — created