diff --git a/packages/opencode/src/tool/question.txt b/packages/opencode/src/tool/question.txt
index 03cd496d60a..29aea37d9ba 100644
--- a/packages/opencode/src/tool/question.txt
+++ b/packages/opencode/src/tool/question.txt
@@ -7,4 +7,6 @@ Use this tool when you need to ask the user questions during execution. This all
 Usage notes:
 - When `custom` is enabled (default), a "Type your own answer" option is added automatically; don't include "Other" or catch-all options
 - Answers are returned as arrays of labels; set `multiple: true` to allow selecting more than one
-- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
+- If you recommend a specific option, make that the first option in the list and add " *" at the end of the label (e.g., "Use TypeScript *")
+- Labels must be concise: 1-5 words, max 30 characters
+- Headers must be very short: max 30 characters