brainstorm

Transforms raw ideas into consensus-backed Design Briefs through structured discovery and challenge.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/hanh-nd/agent-kit --skill brainstorm-hanh-nd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorm
Source: https://github.com/hanh-nd/agent-kit/tree/main/plugins/agent-kit/.gemini/skills/brainstorm
Command: npx skills add https://github.com/hanh-nd/agent-kit --skill brainstorm-hanh-nd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Early-stage ideas, vague feature requests, and unclear requirements often jump straight into implementation without validating the problem, scope, or risks, leading to wasted effort and rework. This Skill runs a structured discovery process that challenges premises, explores alternatives, and produces an agreed Design Brief before any planning begins. ## Core Features & Use Cases - Structured Discovery Phases: Restates the problem, digs for root causes, expands to a 10-star vision, reduces to the narrowest viable wedge, and challenges premises before recommending approaches. - Saturation Gate: Sweeps flow, scope, actors, state, failure modes, privacy, and trust boundaries to confirm the decision surface is stable before writing anything. - Design Brief Output: Saves a human-scannable README decision log plus an AI-optimized DETAIL technical spec via the kit_save_handoff tool. - Use Case: A user says "add sync across devices." The Skill probes the real pain, compares 2-3 solution families with trade-offs, resolves open strategic decisions, then saves an approved Design Brief ready for the planning phase. ## Quick Start Ask the agent to brainstorm your feature idea, for example: brainstorm how we should handle offline-first note syncing across devices.

Frequently Asked Questions about brainstorm

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

FAQPage Schema
How do I turn a vague feature idea into a design document?▼

Invoke the brainstorm skill with your idea as the argument. It restates the problem, probes root causes, compares 2-3 approaches with trade-offs, and saves a Design Brief containing a README decision log and a DETAIL technical spec once you agree.

What is a Design Brief and what does it contain?▼

A Design Brief is the skill's output: a README.md with problem, scope, success criteria, and decisions, plus a DETAIL.md with system flow diagrams, core entities, edge cases, reuse mapping, and handoff notes for the planning phase.

When should I use brainstorming versus going straight to planning?▼

Use brainstorming when scope is ambiguous, multiple valid approaches exist, or the premise is unvalidated. Skip it only for simple, well-understood tasks where the approach is obvious and the main weakness is already known.

Does the brainstorm skill write code or implementation plans?▼

No. Its scope boundary is strictly the Design Brief: no code, no project plans, no tickets. After saving the brief, it offers to hand off to the separate /plan skill for implementation planning.

What is the Saturation Gate in the brainstorm process?▼

The Saturation Gate is a stability check before saving the brief. It sweeps flow, scope, actors, state, failure modes, feasibility, trust, privacy, and wedge integrity, ensuring every area is agreed, out of scope, or explicitly deferred.