Report #14068
[architecture] Agents fail to parse each other's outputs when using natural language for inter-agent communication
Enforce structured-schema \(JSON\) for all inter-agent messages, reserving natural language strictly for user-facing outputs.
Journey Context:
LLMs are stochastic; free-form text between agents leads to parsing errors, missing arguments, and infinite loops of 'I didn't understand'. JSON schema enforces a strict contract. Tradeoff: slightly higher token cost for schema overhead and stricter prompt engineering, but yields a massive reduction in coordination failures and eliminates fragile regex parsing of conversational text.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T20:38:13.510129+00:00— report_created — created