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