brainstorming

Convert ambiguous product ideas into approved design specifications with trade-offs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/zephyrflow97/cadence --skill brainstorming-zephyrflow97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/zephyrflow97/cadence/tree/main/skills/brainstorming
Command: npx skills add https://github.com/zephyrflow97/cadence --skill brainstorming-zephyrflow97

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Prevents premature implementation by turning ambiguous requests and rough ideas into a validated, sectioned design that can be reviewed and approved before any code is written.

Core Features & Use Cases

  • Context exploration — check project files, docs, and recent commits to ground questions in the current codebase.
  • One-question-at-a-time clarifying — refine purpose, constraints, and success criteria through focused follow-ups.
  • Options and recommendation — propose 2–3 approaches with trade-offs and a clear recommendation.
  • Incremental design presentation — present the design in manageable sections and require user approval after each section.
  • Spec authoring & audit — write the validated spec to docs/cadence/specs/YYYY-MM-DD-<topic>-design.md, perform a self-review, request user review, and commit the file.
  • Visual companion support — optionally launch a browser-based mockup/diagram helper for visual questions.

Quick Start

Use the brainstorming skill to convert a short feature idea into a concise, reviewable design, ask clarifying questions one at a time, and save the approved spec to docs/cadence/specs/YYYY-MM-DD-<topic>-design.md.

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I turn vague feature ideas into an approved design specification before coding?

To turn vague ideas into an approved design specification, the skill explores project context, asks one clarifying question at a time, proposes approaches with trade-offs, and presents the design in sections requiring user approval before writing a spec file.

What is the best way to document requirements for cross-module changes with unclear scope?

Documenting requirements for cross-module changes involves stepwise clarification of constraints, proposing 2-3 alternative approaches, and saving the approved sectioned design document directly to the project's specs directory.

How does the incremental design approval process work for new feature specs?

The incremental design approval process presents the specification in manageable sections and requires explicit user approval after each section, ensuring the validated design is reviewed before committing the final markdown file.

Can I use a visual companion to help clarify ambiguous product requirements?

Yes, you can optionally launch a browser-based visual companion helper to generate mockups and diagrams, which assists in clarifying visual product requirements during the brainstorming session.

Does this brainstorming skill check existing project files and recent git commits?

Yes, the skill checks existing project files, documentation, and recent git commits to ground its clarifying questions and proposed design approaches in the current codebase context.

When should I avoid using an automated design spec generator for project planning?

You should avoid using an automated design spec generator for project planning when a request has completely clear scope and immediate implementation is required, as this tool enforces a stepwise clarification and approval gate to prevent premature coding.