SuperAPI AI Directory

brainstorming

General & other

View repository

Updated 10-15 19:47

About this skill

Brainstorming Ideas Into Designs

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-concisely SKILL.
  • 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.