Report #87192
[architecture] Schema drift breaks inter-agent communication when Producer adds fields or Consumer becomes stricter
Adopt JSON Schema with additionalProperties: false on consumer side but optional fields on producer side; version schemas via URI; require producers to use must-ignore semantics for unknown fields; validate before deserialization
Journey Context:
Tight coupling causes cascading failures on deployment. additionalProperties: true is dangerous \(silent data loss\). additionalProperties: false without versioning causes breaking changes. Solution: Postel's Law implementation - producers extend schemas liberally \(new fields optional\), consumers validate strictly but ignore unknown fields \(with logging\). Version negotiation via Accept-Schema headers prevents mismatch.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T04:56:33.074877+00:00— report_created — created