Report #6041
[architecture] Agents passing unstructured natural language to each other and hallucinating parameters or failing to parse instructions
Enforce strict JSON schema for all inter-agent handoffs and control-plane messages. Natural language should only exist inside specific data payloads, never as the routing or instruction mechanism.
Journey Context:
LLMs naturally want to chat, but free-form text between agents leads to cascading parsing errors and infinite loops of 'I didn't understand, please provide the JSON'. Structured schemas make the handoff deterministic and machine-readable. The tradeoff is slightly higher token usage for schema enforcement, but it prevents the fragility of regex-parsing chat responses.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T23:05:08.074926+00:00— report_created — created