brainstorming

Enforce a design-first approval workflow before implementation.

7|3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/brainbrewlabs/brainbrew-devkit --skill brainstorming-brainbrewlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/brainbrewlabs/brainbrew-devkit/tree/main/plugin/config/templates/develop/skills/brainstorming-obra
Command: npx skills add https://github.com/brainbrewlabs/brainbrew-devkit --skill brainstorming-brainbrewlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Prevents premature implementation and wasted work by ensuring ideas are explored, requirements are clarified, and a vetted design is approved before any coding or scaffolding begins. It forces a design-first workflow so assumptions are surfaced, scope is scoped, and success criteria are defined.

Core Features & Use Cases

  • Context exploration: Inspect project files, docs, and recent commits to ground the conversation in the current codebase.
  • One-question-at-a-time clarification: Ask focused clarifying questions sequentially to refine intent, constraints, and success metrics.
  • Approach comparison & recommendation: Propose 2–3 approaches with trade-offs and lead with a recommended option.
  • Design approval gate: Present design sections, get explicit user approval, write a spec to docs/superpowers/specs/, perform a quick self-review, and only then invoke the writing-plans skill.
  • Visual Companion support: Offer browser-based mockups and diagrams when visual decisions are required.

Quick Start

Start by asking the assistant to help brainstorm a design for your feature by describing the goal and constraints, then answer the clarifying questions one at a time so the assistant can propose 2-3 approaches and produce an approvable design.

Frequently Asked Questions about brainstorming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent premature implementation when starting a new feature request?

Clarifying requirements before coding involves inspecting project files and recent commits to ground the conversation, then asking focused clarifying questions sequentially to refine intent, constraints, and success metrics before proposing approaches.

What's the best way to compare design approaches for UI/UX changes?

The best way to compare design approaches is to propose 2–3 options with explicit trade-offs, lead with a recommended option, and present them for explicit user approval before generating and committing a written spec to the project docs.

How do I write and commit a spec for a small utility after brainstorming?

After brainstorming, writing and committing a spec involves passing a design approval gate, generating the written specification, saving it to docs/superpowers/specs/, performing a quick self-review, and only then invoking the writing-plans skill.

Can I use brainstorming for project decomposition and scope definition?

Yes, this brainstorming workflow applies to project decomposition tasks where clarifying intent, constraints, success criteria, and scope is required to prevent wasted work and surface assumptions before implementation begins.

Does the design approval workflow support visual companion mockups?

Yes, the design approval workflow offers browser-based visual companion mockups and diagrams when visual decisions are required, helping ground the iterative context exploration and approach comparison phases before generating a written spec.