brainstorm

Guides structured discovery dialogue, approach selection, and spec drafting through a seven-phase protocol.

Updated Sep 14, 2026
One-click install
npx skills add https://github.com/pandejesal/drone-nav-sar --skill brainstorm-pandejesal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorm
Source: https://github.com/pandejesal/drone-nav-sar/tree/main/.swarm/bundled-skills/brainstorm
Command: npx skills add https://github.com/pandejesal/drone-nav-sar --skill brainstorm-pandejesal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a fuzzy, exploratory idea into a well-formed specification is hard: requirements stay implicit, assumptions go unrecorded, and teams jump to implementation too early. This Skill enforces a disciplined seven-phase brainstorm protocol that draws requirements out through structured dialogue before any spec is committed. ## Core Features & Use Cases - Seven-Phase Protocol: Runs context scan, optional council advisory, one-question-at-a-time dialogue, candidate approach comparison, design drafting, spec writing with reviewer sign-off, and a controlled transition to planning. - Clarification Funnel: Classifies uncertainties (self_resolved, critic_resolved, research_needed, user_decision, deferred_nonblocking), applies an overconfidence guard, and surfaces only surviving items as [NEEDS CLARIFICATION] markers. - Independent Spec Review: Delegates the draft spec to a reviewer agent that flags HOW-encoded requirements, untestable requirements, missing edge cases, and silent assumptions. - Use Case: A user says "let's think through adding multi-tenant support." The Skill maps the codebase, asks up to six focused questions with informed defaults, presents 2-4 candidate approaches with tradeoffs, and produces a reviewed .swarm/spec.md ready for planning. ## Quick Start Ask the architect to brainstorm your idea, for example by saying "brainstorm how we should add audit logging to the API."

Frequently Asked Questions about brainstorm

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

FAQPage Schema
How do I brainstorm a software feature before writing a spec?

Invoke the brainstorm mode with a phrase like "brainstorm" or "let's think this through." The protocol scans the codebase, asks one focused question at a time with informed defaults, presents candidate approaches, and drafts a reviewed spec.

When should I use brainstorm mode instead of specify mode?

Use brainstorm when requirements are fuzzy or exploratory and need to be drawn out through dialogue. Use specify when you have already articulated clear requirements and want to go straight to spec writing.

How many questions does the brainstorm dialogue ask?

The dialogue phase asks exactly one question per message and is hard-capped at six questions total. It stops sooner once remaining ambiguity can be safely defaulted, and every question includes why it matters and the default that will be used.

What happens to unresolved questions in the generated spec?

Unresolved items pass through a clarification funnel that classifies them as self_resolved, critic_resolved, research_needed, user_decision, or deferred_nonblocking. Only survivors appear as [NEEDS CLARIFICATION] markers with recommended defaults and blocking status.

Does brainstorm mode write the implementation plan automatically?

No. Brainstorm ends with a transition phase that summarizes the chosen approach and spec, then offers PLAN or CLARIFY-SPEC as next steps. It waits for explicit user direction and never proceeds automatically.