Report #102095
[architecture] Agents passing free-form natural language instead of typed messages
Define a strict message schema \(tool call, observation, plan, handoff\) and validate every inter-agent message against it. Free-form text is allowed only inside a designated 'content' field, never as the protocol.
Journey Context:
Natural-language handoffs feel flexible at first but become brittle: parsers drift, context gets reinterpreted, and errors are hard to attribute. Typed schemas force the caller and callee to agree on shape, which makes retries, caching, and observability trivial. The MCP specification is built on JSON-RPC with typed requests, results, and errors for this reason. The tradeoff is upfront schema design; the payoff is that you can test agent boundaries the same way you test API contracts.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-08T04:57:52.893527+00:00— report_created — created