Overview
Helps turn ideas into concrete designs and specs through natural collaborative conversation.
First understand the current project context, then ask questions one at a time to refine the idea. Once you understand what is being built, present the design in small sections (200-300 characters), and check whether what has been covered so far is correct at the end of each section.
The Process
Understanding the idea:
- First check the current project state (files, documentation, recent commits).
- Ask questions one at a time to refine the idea.
- Prefer multiple choice questions when possible, but open-ended questions are fine too.
- Ask only one question per message. If a topic needs more exploration, split it into multiple questions.
- Focus on understanding: purpose, constraints, success criteria.
Exploring approaches:
- Propose 2-3 different approaches with trade-offs.
- Present options conversationally, including a recommendation and the reasons for it.
- Present the recommended option first and explain why.
Presenting the design:
- Once you believe you understand what to build, present the design.
- Split the design into sections of about 200-300 characters.
- At the end of each section, check whether what has been covered so far is correct.
- Content: architecture, components, data flow, error handling, testing.
- If there is anything unclear, be prepared to go back and explain it clearly.
After the Design
Documentation:
- Write the validated design to
docs/plans/YYYY-MM-DD-<topic>-design.md. - If available, use the
elements-of-style:writing-clearly-and-conciselySKILL. - Commit the design document to git.
Implementation - if continuing:
- Ask, "Shall we start setting up for implementation?"
superpowers:using-git-worktreesUse to create an isolated workspace.superpowers:writing-plansUse to write a detailed implementation plan.
Key Principles
- One question at a time - Do not overwhelm with multiple questions.
- Multiple choice preferred - Easier to answer than open-ended when possible.
- YAGNI ruthlessly - Remove unnecessary features from every design.
- Explore alternatives - Always propose 2-3 approaches before deciding.
- Incremental validation - Present the design section by section and validate each section.
- Be flexible - When something is unclear, go back and clarify it.