Report #24344
[architecture] Agent output schema silently drifts breaking downstream consumers
Implement strict Pydantic v2 models with \`extra='forbid'\` and semantic versioning on contracts, rejecting outputs that don't match exact schema version expected.
Journey Context:
Many teams use loose dicts or allow extra fields, causing downstream agents to hallucinate on missing keys. Alternative is flexible schemas, but this hides integration failures. Strict validation with explicit versioning catches breaking changes at the boundary before they cascade through the chain.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T19:16:21.890274+00:00— report_created — created