clarification-protocol

To stop subagents from prompting users, configure them to return structured flags and headers instead of interactive questions. This flag-based clarification protocol defers decisions to the main context, keeping automated workflows deterministic.

Flag-based clarification in multi-agent orchestration is a protocol where subagents return structured payload with flags and options. The main context interprets this data to prompt users with a concise choice, avoiding subagent workflow stalls.

Structure subagent return data by emitting a clarification payload that includes specific flags, headers, and options. This format guides the main context to interpret the ambiguity and present structured choices to the user without interactive prompts.

Yes, you can use structured flags instead of interactive questions in automated agent workflows. This protocol prevents prompt fatigue by ensuring subagents defer user input requests to the main context through structured return data.

Use a clarification protocol in multi-agent workflows when a subagent encounters ambiguity about user intent. Returning a clarification payload to the main agent prevents workflow derailment and ensures the main context handles the user prompt.

A limitation of flag-based subagent clarifications is that the main context must be wired to interpret the returned headers and options. If the main context cannot parse the structured flags, it cannot present the structured choice to the user.