brainstorming

Convert ambiguous product intent into an approved design specification.

Updated May 13, 2026
One-click install
npx skills add https://github.com/kimprobably/maestro-os --skill brainstorming-kimprobably
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/kimprobably/maestro-os/tree/main/hermes/distribution/maestro-operator/skills/brainstorming
Command: npx skills add https://github.com/kimprobably/maestro-os --skill brainstorming-kimprobably

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill prevents wasted implementation work by forcing a clear, user-approved design before any code changes are made.

Core Features & Use Cases

  • Structured requirement discovery: Explores project context first (files, docs, recent commits) to ground the design in current reality.
  • Guided questioning loop: Asks clarifying questions one at a time to refine purpose, constraints, and success criteria.
  • Design proposal with trade-offs: Presents 2–3 approaches and a recommended direction, then walks the user through an approval-gated design.
  • Spec authoring and review gate: Writes the validated spec to docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md, commits it, and requests user review before planning implementation.
  • Optional visual support: Offers a browser-based “Visual Companion” for mockups/diagrams when the topic is meaningfully visual.

Quick Start

Use the brainstorming skill to produce an approved design for the change you want to make, following the hard gate that blocks implementation until the design is reviewed and approved.

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I define product requirements before implementation begins?▼

To define product requirements, explore project context like files and recent commits, then ask clarifying questions one at a time to refine purpose, constraints, and success criteria before producing an approved design plan.

What is the best way to evaluate trade-offs for component design?▼

Evaluating trade-offs for component design involves presenting 2–3 approaches with a recommended direction. This allows you to compare options and select an approved path forward before writing a specification document.

How do I write an approved specification for behavioral changes?▼

Writing an approved specification for behavioral changes requires an approval-gated design presentation. After proposing approaches and receiving user approval, the validated spec is committed to a dedicated project specs directory.

Can I visualize mockups during the product planning dialogue?▼

Yes, you can visualize mockups during product planning using a browser-based Visual Companion. This optional tool provides visual support for mockups and diagrams when the design topic is meaningfully visual.

When do I need user approval for spec writing?▼

User approval for spec writing is needed before implementation begins and before handing off to a planning skill. A hard review gate blocks code changes until the design spec is explicitly reviewed and approved by the user.

How to refine scope for ambiguous engineering intent?▼

Refining scope for ambiguous engineering intent starts with a context exploration step to ground the design in current reality. A guided questioning loop clarifies the requested work when it could be implemented in multiple ways.