From b099171b0ce022743d3cd8614fad130a730251d3 Mon Sep 17 00:00:00 2001
From: jwbron <8340608+jwbron@users.noreply.github.com>
Date: Thu, 7 May 2026 05:21:16 +0000
Subject: [PATCH] docs: add --for STATUS to producer pre-confirm wait-loop
 example

Syncs docs/guides/concurrent-execution.md with the fix from #2531:
the producer RESPOND TO REVIEWS (step 4) wait-loop now includes
--for STATUS so the orchestrator's "Ready to confirm" directed nudge
wakes the producer when every reviewer has already ACKed and no
further CONSENSUS_ACK/CONSENSUS_NACK will arrive.

docs/reference/agent-wait-patterns.md was already updated in the
same PR; this doc had a stale copy of the canonical snippet.

Authored-by: egg
---
 docs/guides/concurrent-execution.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/guides/concurrent-execution.md b/docs/guides/concurrent-execution.md
index 2633309de0..8ea8ce67bd 100644
--- a/docs/guides/concurrent-execution.md
+++ b/docs/guides/concurrent-execution.md
@@ -116,7 +116,12 @@ egg-orch message wait-loop \
   --for CONSENSUS_ACK \
   --for CONSENSUS_NACK \
   --for CONSENSUS_RE_REVIEW \
+  --for STATUS \
   --for OVERSEER_ALERT
+# `--for STATUS` is required (#2531): once every reviewer has ACKed the current version,
+# no further CONSENSUS_ACK/CONSENSUS_NACK arrive; the orchestrator emits a directed
+# STATUS (metadata.ready_to_confirm == true) as the only signal that confirms are clear.
+# On wake: if metadata.ready_to_confirm is true, go to CONFIRM; otherwise re-enter the wait.
 
 # Producer STAY ALIVE (post-confirm, step 6) — exits on consensus, re-review, or overseer alert
 egg-orch message wait-loop \