Report #79790
[architecture] Agents communicating state changes via free-form natural language
Enforce structured schema \(JSON\) for all inter-agent messages and handoffs; reserve natural language strictly for user-facing reasoning or semantic search.
Journey Context:
Natural language seems flexible but introduces parsing ambiguity and hallucinated state. If an agent misses a parameter in an NL message, it requires an entire extra LLM call to clarify. Structured schemas enforce contracts, guarantee state keys exist, and make programmatic validation possible without LLM intervention, drastically reducing cascading errors.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T16:31:36.331419+00:00— report_created — created