From d2c4cee6f9774a5fb2c8ca325c389dadb4a72b1c Mon Sep 17 00:00:00 2001 From: Trevin Chow Date: Sun, 15 Mar 2026 11:57:10 -0700 Subject: [PATCH] feat: instruct brainstorm skill to use platform blocking question tools Name specific blocking question tools (AskUserQuestion, request_user_input, ask_user) so agents actually invoke them instead of printing questions as text output. Updates skill compliance checklist to match. --- plugins/compound-engineering/CLAUDE.md | 6 +++--- plugins/compound-engineering/skills/ce-brainstorm/SKILL.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/plugins/compound-engineering/CLAUDE.md b/plugins/compound-engineering/CLAUDE.md index a1e9370..5c8e6b4 100644 --- a/plugins/compound-engineering/CLAUDE.md +++ b/plugins/compound-engineering/CLAUDE.md @@ -76,10 +76,10 @@ When adding or modifying skills, verify compliance with skill-creator spec: - [ ] Use imperative/infinitive form (verb-first instructions) - [ ] Avoid second person ("you should") - use objective language ("To accomplish X, do Y") -### AskUserQuestion Usage +### Cross-Platform User Interaction -- [ ] Avoid `AskUserQuestion` for skills intended to run cross-platform (see `ce-brainstorm/SKILL.md` pattern) -- [ ] If the skill does use `AskUserQuestion`, it must include an "Interaction Method" preamble explaining the numbered-list fallback for non-Claude environments +- [ ] When a skill needs to ask the user a question, instruct use of the platform's blocking question tool and name the known equivalents (`AskUserQuestion` in Claude Code, `request_user_input` in Codex CLI, `ask_user` in Gemini CLI) +- [ ] Include a fallback for environments without a question tool (e.g., present numbered options and end the turn) ### Quick Validation Command diff --git a/plugins/compound-engineering/skills/ce-brainstorm/SKILL.md b/plugins/compound-engineering/skills/ce-brainstorm/SKILL.md index baac137..f7167af 100644 --- a/plugins/compound-engineering/skills/ce-brainstorm/SKILL.md +++ b/plugins/compound-engineering/skills/ce-brainstorm/SKILL.md @@ -28,7 +28,7 @@ This skill does not implement code. It explores, clarifies, and documents decisi 1. **Ask one question at a time** - Do not batch several unrelated questions into one message. 2. **Prefer single-select multiple choice** - Use single-select when choosing one direction, one priority, or one next step. 3. **Use multi-select rarely and intentionally** - Use it only for compatible sets such as goals, constraints, non-goals, or success criteria that can all coexist. If prioritization matters, follow up by asking which selected item is primary. -4. **Keep this workflow cross-platform** - Use a platform's interactive question mechanism when available; otherwise present numbered options in chat and wait for the user's reply. +4. **Use the platform's question tool when available** - When asking the user a question, prefer the platform's blocking question tool if one exists (`AskUserQuestion` in Claude Code, `request_user_input` in Codex CLI, `ask_user` in Gemini CLI). Otherwise, present numbered options in chat and end the turn. ## Output Guidance @@ -113,7 +113,7 @@ Before generating approaches, challenge the request to catch misframing. Match d #### 1.3 Collaborative Dialogue -Use the platform's interactive question mechanism when available. Otherwise, present numbered options in chat and wait for the user's reply before proceeding. +Use the platform's blocking question tool when available (see Interaction Rules). Otherwise, present numbered options in chat and end the turn. **Guidelines:** - Ask questions **one at a time** @@ -247,7 +247,7 @@ If a document contains outstanding questions: #### 4.1 Present Next-Step Options -Present next steps using the platform's interactive question mechanism when available. Otherwise present numbered options in chat and wait for the user's reply. +Present next steps using the platform's blocking question tool when available (see Interaction Rules). Otherwise present numbered options in chat and end the turn. If `Resolve Before Planning` contains any items: - Ask the blocking questions now, one at a time, by default