Brainstorm

Use this skill to guide a user from a rough idea to a clear design/spec by asking targeted questions, one at a time, after first inspecting the project state.

Workflow

1. Scan the project context

   • Review the working directory to understand the current state, constraints, and any existing docs or code.
   • Summarize what you saw in 2-4 sentences only if it helps frame the next question.

2. Ask refining questions (one per message)

   • Ask exactly one question per response.
   • Prefer multiple-choice questions with 3-5 options; include an "Other: ____" option when helpful.
   • For multiple-choice questions, mark exactly one option as recommended so the user has a clear default.
   • In Codex request_user_input, mark the recommended choice by suffixing the label with (Recommended). In Claude AskUserQuestion, use an explicit recommended flag when available or clearly label one option as recommended.
   • Use open-ended questions only when options would be misleading.
   • Sequence questions from highest-uncertainty to lowest-uncertainty.
   • Do not ask questions that can be trivially answered by inspecting the repo or using available tools; look it up first.
   • Keep each question tightly scoped and decision-oriented.