Report #38417
[architecture] Integration failures in production despite individual agent unit tests passing
Implement consumer-driven contract tests \(CDCT\) where downstream agents \(consumers\) publish their input schema expectations; upstream agents \(providers\) verify against these contracts in CI/CD using tools like Pact, failing the build if the provider output breaks the consumer contract.
Journey Context:
In multi-agent systems, each agent passes 'unit tests' in isolation, but production still breaks because Agent A changed a field name that Agent B depends on. Traditional end-to-end tests are flaky and slow for LLM agents. The alternative—manual schema coordination—doesn't scale. CDCT inverts the dependency: the consumer \(downstream agent\) defines the contract, and the provider \(upstream\) must satisfy it. This catches breaking changes at build time, not in production. The tradeoff is organizational: consumers must write and maintain the contracts, and providers must run them in CI. But this explicit contract is precisely the 'schema boundary' needed for reliable agent swarms.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T18:57:48.585679+00:00— report_created — created