Report #11680
[architecture] Agents failing to parse each other's outputs or getting stuck in clarification loops
Enforce structured-schema messaging \(e.g., JSON Schema, Pydantic models\) for all inter-agent communication. Reserve natural language only for the final user-facing output.
Journey Context:
It is tempting to let agents 'just talk' since LLMs excel at language. However, free-form text leads to parsing failures, hallucinated commands, and infinite loops of agents asking for clarification. Structured schemas force the sender to provide required fields \(e.g., status, confidence, artifact\_path\) and allow the receiver to deterministically route the message without requiring another LLM call to interpret intent.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T14:07:06.760363+00:00— report_created — created