Report #7164
[architecture] Agents communicating via unstructured natural language causing hallucination cascades and parsing failures
Enforce structured-schema \(JSON/Pydantic\) messaging for all inter-agent communication; reserve natural language strictly for the human-facing boundary.
Journey Context:
LLMs frequently hallucinate or omit critical parameters when generating free-form text for other agents to parse. A structured schema acts as a hard contract, forcing the emitting agent to populate required fields and allowing the receiving agent to parse deterministically. The tradeoff is a slight increase in token overhead for schema keys, but this is vastly cheaper than recovering from a cascading parsing error loop.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T02:04:17.745506+00:00— report_created — created