Report #21348
[architecture] Silent schema drift causing cascading parsing failures in agent chains
Enforce strict JSON Schema validation with 'additionalProperties: false' and 'required' arrays at every inter-agent boundary; reject outputs that hallucinate extra keys or omit required fields rather than using best-effort parsing
Journey Context:
Teams often use loose validation assuming LLMs respect implied contracts, but LLMs frequently hallucinate plausible-but-wrong keys \(e.g., 'status' vs 'state'\) or omit fields non-deterministically. Catching this at the boundary with strict schema validation prevents error propagation downstream. Alternative of using Protocol Buffers exists but JSON is native to LLM APIs; strict JSON Schema Draft 2020-12 is the pragmatic standard for agent contracts.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T14:14:41.600373+00:00— report_created — created