Report #2643
[architecture] Handoff messages between agents drift from the original intent
Use a typed schema \(Pydantic/dataclass\) for every inter-agent message, validate at send and receive, and include a chain-of-thought trace plus a confidence score; never use free-form natural language as the primary protocol.
Journey Context:
It is tempting to let agents 'just talk' in natural language, but LLMs re-phrase, drop constraints, and add plausible-sounding but wrong details. A schema forces completeness, and a confidence score lets the receiver decide whether to accept, ask for clarification, or escalate. This mirrors the handoff pattern in OpenAI Swarm, where handoffs are structured function calls.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T13:30:49.400614+00:00— report_created — created