Refine rough ideas into clear, validated specs through Socratic design before writing any code
Convert a vague idea into a clear, validated specification before a single line of code is written. This is the #1 way to prevent building the wrong thing.
Borrowed from: obra/superpowers — The Socratic design methodology
Ask the user ONE question at a time:
Wait for answers before proceeding. Do NOT ask multiple questions at once.
After getting answers, identify and challenge:
Present challenges ONE AT A TIME. Get confirmation before moving on.
Propose 2-3 alternative approaches:
Break the confirmed design into sections of max 200 words each. Present one section, get user confirmation, then next section. Do NOT dump the entire design at once.
Sections to cover:
After presenting all sections: "Does this match what you have in mind?" If yes → create PROJECT_SPEC.md and hand off to writing-plans skill If no → go back to the section that's wrong
docs/PROJECT_SPEC.md — complete validated specificationUser: "I want to build a tool that helps people remember what they read" AI: "Great — in one sentence, what does success look like for someone using this tool?" → Follow the step-by-step process above