brainstorming

Guides a five-step workflow that produces a DISCUSSION.md clarifying goals, scope, options, and recommendations before design or planning.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/truongnat/Restly --skill brainstorming-truongnat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/truongnat/Restly/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/truongnat/Restly --skill brainstorming-truongnat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump from a vague request straight into code or planning, which leads to wrong assumptions, missed constraints, and rework. This Skill forces a structured clarification phase that turns an initial request into a documented direction with separated facts, assumptions, and unknowns before any design or planning begins. ## Core Features & Use Cases - Forced step sequence: Seeds a DISCUSSION.md from a template, then walks through framing, spec quality review (feasibility, correctness, capability gaps), scope and options matrix, recommendation, and a self-check ledger. - Confirm-first clarification: Stops immediately on Critical or blocking issues, classifies the ask method (confirm, choice, fact, table, diagram, or HTML), and records questions and answers in a clarification checkpoint. - Optional visual decision aid: Generates an accessible VISUAL_DECISION.html with Tailwind and anime.js CDN tags for spatial or multi-state decisions, only after user confirmation. - Use Case: A stakeholder asks to add a search feature to an internal tool. The Skill seeds DISCUSSION.md, challenges the spec's feasibility against the repo, asks focused blocking questions, compares two implementation options, and hands off to the planning skill with a clear recommendation. ## Quick Start Ask the agent to use the brainstorming skill to clarify the goal, scope, and options for your feature request and produce a DISCUSSION.md before any planning.

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I clarify requirements before writing a project plan?▼

Use a structured brainstorming workflow that seeds a discussion document, separates facts from assumptions and unknowns, reviews spec quality, and compares options before recommending a direction. This Skill enforces that sequence and blocks planning until blocking questions are answered.

What should a technical discovery document include?▼

A discovery document should include a one-sentence goal, desired outcomes, confirmed facts, constraints, assumptions with risk levels, unknowns with owners, issue triage, a spec quality review, scope in and out, an options matrix, a recommendation with confidence, and a handoff to the next phase.

When should I not use a brainstorming workflow?▼

Skip it for tiny, clear fixes where a quick path to planning is enough, when a discussion document already exists and the user wants execution, or for pure debugging and code review tasks. The Skill explicitly defines these exclusion cases.

How do I handle blocking unknowns during requirement gathering?▼

Stop immediately, classify the ask method such as confirm, choice, fact, table, diagram, or HTML, ask one focused question, and record the answer in a clarification checkpoint. Do not continue to scope or options while Critical or blocking items remain unresolved.

Can the brainstorming skill generate visual decision aids?▼

Yes, but only for issues where spatial or multi-state comparison materially improves the decision, and only after user confirmation. It produces an accessible VISUAL_DECISION.html using Tailwind and anime.js CDN tags, served via a session-serve tool to record choices.