skills.rest
baleen37
baleen37COMMUNITY
Explore all skills by this author →
GitHub

brainstorming

Guide rough ideas into validated designs through structured questioning and incremental feedback.

10|Updated Dec 15, 2014
Search Tags:#design#planning#architecture#brainstorming#requirements#validation#product development
Ready to run
npx skills add https://github.com/baleen37/dotfiles --skill brainstorming-baleen37
💬 Prompt for ChatGPT / Claude Chat▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/baleen37/dotfiles/tree/main/modules/shared/config/claude/skills/brainstorming
Command: npx skills add https://github.com/baleen37/dotfiles --skill brainstorming-baleen37

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rough ideas often lack the structure and detail needed for effective implementation. This skill transforms initial concepts into fully-formed designs through structured Socratic questioning, exploration of alternatives, and incremental validation, ensuring a robust foundation before any code is written.

Core Features & Use Cases

  • Structured Understanding: Uses one-at-a-time questions and multiple-choice options to clarify purpose, constraints, and success criteria.
  • Alternative Exploration: Proposes 2-3 architectural approaches with trade-offs, guiding selection.
  • Incremental Design Presentation: Presents design in sections, validating each part with open-ended questions for feedback.
  • Use Case: When starting a new feature, this skill will guide you from a vague idea like "add user profiles" to a detailed design covering data storage, API architecture, and error handling, validated at each step.

Quick Start

1. Phase 1: Understanding

- Ask ONE question at a time to refine the idea.

- Use AskUserQuestion for multiple choice options.

- Gather purpose, constraints, success criteria.

2. Phase 2: Exploration

- Propose 2-3 different architectural approaches with trade-offs.

- Use AskUserQuestion to present choices.

3. Phase 3: Design Presentation

- Present design in 200-300 word sections.

- Ask "Does this look right so far?" after each section.

4. Phase 4: Design Documentation

- Write design to docs/plans/YYYY-MM-DD-<topic>-design.md.