fix(sdd): controllers wait long or not at all

Docs-only wait guidance in the platform reference changed nothing
(65.1% vs 67.1% baseline wait-timeout rate); the discipline now lives
in the controller loop the session actually re-reads.
This commit is contained in:
Jesse Vincent
2026-07-30 12:50:42 -07:00
parent 9b8b14fe12
commit db4538fcb8

View File

@@ -197,6 +197,14 @@ Everything you paste into a dispatch prompt — and everything a subagent
prints back — stays resident in your context for the rest of the session
and is re-read on every later turn. Hand artifacts over as files.
**Waiting on dispatched subagents:** never poll a wait interface with
short timeouts. While you have local work — ledger updates, packaging
the next review, reading reports — keep working; child results arrive
on their own. Wait only when you are genuinely idle, and then issue one
long wait (fifteen minutes or more, where your platform allows it)
instead of many short ones: a long wait wakes just as fast and costs
one call instead of dozens.
### 1. Dispatch the implementer
Record BASE (`git rev-parse HEAD`) before dispatching — the review package