Report #76548
[architecture] Integration failures discovered late when downstream agents break due to upstream output schema changes
Implement consumer-driven contract testing using Pact or similar; downstream agents \(consumers\) publish expectations \(pacts\) to a broker; upstream agents \(providers\) verify against these pacts in CI/CD before deployment; reject provider deployments that break existing consumer contracts; version pacts by consumer version to allow parallel evolution
Journey Context:
Traditional integration testing requires full environment setup and is slow; schema validation alone doesn't catch semantic changes \(e.g., field 'status' values changing from 'ok'/'fail' to 'success'/'failure'\); the hard-won insight is that in multi-agent systems, contracts must be tested at the integration level without requiring the actual services to run, and that the consumer must drive the contract because they bear the cost of breaking changes, enabling independent deployment velocities
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T11:04:55.271655+00:00— report_created — created