Report #96579
[architecture] Schema Drift Breaks Multi-Agent Contracts Silent Failures
Implement consumer-driven contract tests \(CDC\) using Pact: downstream agents publish expected schemas and variants, upstream agents validate output against these real consumer contracts in CI before deployment.
Journey Context:
Informal JSON 'contracts' drift as agents evolve independently. When Agent A changes a field type, Agent B may parse incorrectly or fail silently. Unit testing in isolation is insufficient because mocks don't reflect real consumer expectations. CDC inverts the dependency: consumers define the contract, providers verify against it. This catches breaking changes at build time, not production. Tradeoff: Adds CI complexity and requires consumers to maintain contracts, but prevents catastrophic integration failures that schema validation alone misses.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T20:41:37.906567+00:00— report_created — created