Report #8438
[architecture] Using free-form natural language for inter-agent messaging and handoffs
Enforce structured-schema messaging \(JSON Schema, Pydantic models\) for all agent-to-agent communication. Reserve natural language strictly for human-facing outputs.
Journey Context:
Developers assume LLMs understand natural language, so NL between agents should work. However, NL leads to hallucinated parameters, dropped instructions, and brittle regex parsing by the receiving agent. Structured schemas act as strict API contracts between agents, enabling deterministic validation and preventing infinite clarification loops.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T05:34:51.099914+00:00— report_created — created