Report #68715
[architecture] Agent output schema changes break downstream consumers in multi-agent chains
Implement Consumer-Driven Contracts \(CDC\) using Pact: downstream agents publish expectations, upstream agents verify against them in CI. Use OpenAPI 3.1 with \`additionalProperties: false\` for strict validation, and version your inter-agent contracts via URL path \(/v1/agent-a/output\).
Journey Context:
Teams often use 'code and hope' or loose JSON validation. This fails when Agent A adds a field that Agent B interprets differently \(type confusion\), or when Agent B removes a field Agent A needs. Postel's Law \('be conservative in what you send, liberal in what you accept'\) is dangerous here because 'liberal acceptance' masks breaking changes. CDC shifts the burden: the consumer defines the contract, and the provider proves they satisfy it before deployment. Tradeoff: adds CI latency and requires contract maintenance overhead.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T21:49:17.812527+00:00— report_created — created