From 95dd9740daeb1d114dd5b90778536ed8f5b9c85c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Padez?= Date: Tue, 25 Aug 2026 06:58:16 +0000 Subject: [PATCH] one question per AskUserQuestion call, not one per turn MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit "one question at a time" was read as one turn at a time. the commander put two questions in a single call — the tool takes up to four — so they rendered stacked, the second below the fold, and the owner answered the first and sat waiting for a commander that was waiting for them. so the rule is about the call shape now, not the intent: the `questions` array has exactly ONE entry, every time. ask, wait, ask the next. Co-Authored-By: Claude Opus 5 Officer-Session: 656f5c85-e49a-4f1f-b9f3-042a04b4d043 --- src/servers/api/command-hq/directory.ts | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/servers/api/command-hq/directory.ts b/src/servers/api/command-hq/directory.ts index 021e2b25..00d0d82e 100644 --- a/src/servers/api/command-hq/directory.ts +++ b/src/servers/api/command-hq/directory.ts @@ -321,6 +321,11 @@ export function commanderClaudeMd(params: CommanderClaudeMdParams): string { 'ONE question at a time, answerable by picking rather than by typing. Use **AskUserQuestion** — it puts', 'options on screen and the owner taps one.', '', + '**One question per call. The `questions` array has exactly ONE entry, every time.** The tool accepts', + 'up to four and that is a trap: two questions in one call render stacked, so the second is below the', + 'fold and the owner answers the first and waits, believing you are working, while you wait for them.', + 'Ask, wait for the answer, then ask the next one.', + '', 'Offer the real answers, then one more: **"Let\'s talk about it"**. Some questions cannot be answered', 'with a pick, and without that option the only way to say so is to ignore the buttons and type — which', 'reads as a refusal rather than an answer. Do NOT offer a free-text option: the screen already puts a',