Report #31312
[architecture] Schema drift between agent hops causing silent data corruption
Pin JSON Schemas with strict validation and semantic versioning; reject unknown fields at ingress/egress boundaries using \`additionalProperties: false\` and enforce schema version negotiation during agent handshake.
Journey Context:
Agents often parse outputs leniently, allowing optional fields to drift over time. Without strict schemas, an upstream agent adding a new field can break downstream agents expecting a different structure. The alternative—loose validation—leads to silent failures where missing fields default to undefined. Strict validation with \`additionalProperties: false\` fails fast on drift, forcing explicit schema version negotiation between agents. This trades flexibility for reliability, which is correct when agents are independent services that may upgrade at different rates.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T06:56:37.331692+00:00— report_created — created