brainstorming

Guides structured dialogue to turn feature ideas into approved design documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Jumping straight into code without a validated design leads to misaligned assumptions, scope creep, and costly rework. This Skill enforces a design-first workflow that explores user intent, constraints, and alternatives before any implementation begins. ## Core Features & Use Cases - Structured Discovery: Explores project context, then asks clarifying questions one at a time to understand purpose, constraints, and success criteria. - Approach Comparison: Proposes 2-3 alternative approaches with trade-offs and a reasoned recommendation before settling on a direction. - Incremental Design Approval: Presents the design in sections scaled to complexity, requiring explicit user approval before writing the design doc to docs/plans/ and transitioning to the writing-plans skill. - Use Case: A user says "let's add dark mode to the app." The Skill checks the current theme implementation, asks whether it should be automatic or manual, compares CSS variables vs. Tailwind dark classes vs. a theme provider, presents the design section by section, and only after approval writes the design document and hands off to planning. ## Quick Start Ask the assistant to help you design a new feature or change, for example: "Help me brainstorm and design a notification system for my app before we build it."

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I design a feature before writing code?

Start by exploring the current project context, then ask clarifying questions one at a time about purpose, constraints, and success criteria. Propose 2-3 approaches with trade-offs, present the design in sections for approval, and save the validated design to docs/plans/ before implementation.

What should a software design document include?

A design document should cover architecture, components, data flow, error handling, and testing strategy. Keep it focused on what and why, not step-by-step implementation instructions, which belong in a separate implementation plan.

Should simple tasks like utility functions go through a design phase?

Yes, but scaled down. Even a single-function utility benefits from a brief design confirming expected behavior, since assumptions on simple tasks are the most dangerous. A 30-second confirmation prevents a 30-minute refactor.

What happens after the design is approved?

The validated design is written to docs/plans/YYYY-MM-DD-topic-design.md and committed to git. The workflow then transitions to the writing-plans skill, which creates the detailed implementation plan before any implementation skills are invoked.

What if the user wants to skip design and just start coding?

Acknowledge the urgency, explain the rework risk, and propose a time-boxed design with one or two quick questions. If the user still insists, present a minimal design statement and get explicit approval before proceeding.