brainstorming

Guide software projects through design approval before implementation begins.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates wasted implementation work caused by unexamined assumptions and skipped design phases, even for seemingly simple projects, by enforcing collaborative design validation before any coding or scaffolding begins.

Core Features & Use Cases

  • Guided collaborative dialogue: Asks one clarifying question at a time to refine user intent, requirements, constraints, and success criteria.
  • Mandatory design approval gate: Requires presenting 2-3 approach trade-offs and a full design for user approval before any implementation work starts.
  • Optional visual companion: Provides a browser-based tool for mockups, diagrams, and visual comparisons when questions benefit from visual treatment.
  • Automated spec workflow: Writes, self-reviews, and commits a formal design spec, then hands off to implementation planning.
  • Use Case: If you want to add a new user authentication feature, this Skill will walk you through clarifying requirements, comparing session vs JWT approaches, presenting a full design for approval, and writing a formal spec before any code is written.

Quick Start

Use the brainstorming skill to refine your idea for a new todo list feature into an approved design before starting implementation.

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I validate software design assumptions before starting implementation?

To validate software design assumptions before implementation, enforce a collaborative design validation phase covering context exploration, clarifying questions, approach trade-off analysis, and mandatory design approval gates. This structured workflow prevents wasted implementation work caused by unexamined requirements and skipped design phases.

What is pre-development spec writing and when do I need it for software projects?

Pre-development spec writing is the process of documenting a formal design specification before any coding or scaffolding begins. You need it for all software project scopes, from simple utilities to complex multi-subsystem platforms, to eliminate wasted implementation work caused by skipped design phases and unexamined assumptions.

How do I plan a new feature design step by step from an initial idea?

Planning a new feature design from an initial idea involves guided collaborative dialogue where you refine user intent, requirements, constraints, and success criteria one question at a time. You then compare 2-3 approach trade-offs, present a full design for approval, and write a formal spec before implementation planning handoff.

Can I use structured design validation for small utility projects or is it only for complex subsystems?

Structured design validation applies to all project scopes from simple utilities to complex multi-subsystem platforms. It covers feature creation, component building, functionality additions, and behavior modifications, ensuring even seemingly simple projects avoid wasted implementation work from unexamined assumptions.

What's the best way to compare software design approaches before committing to code?

The best way to compare software design approaches is through a mandatory design approval gate that presents 2-3 approach trade-offs for user review. This structured comparison ensures you analyze different architectural options, like session versus JWT for authentication, before any implementation work starts.

How do I refine project requirements when initial feature ideas are too vague to implement?

To refine vague project requirements, use a guided collaborative dialogue that asks one clarifying question at a time. This structured approach systematically refines user intent, technical constraints, and success criteria until requirements are concrete enough to support formal spec writing and implementation planning.