brainstorming

Refines ideas into approved design specs through structured collaborative dialogue.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/stefanfaur/roach-marketplace --skill brainstorming-stefanfaur
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/stefanfaur/roach-marketplace/tree/main/roach/skills/brainstorming
Command: npx skills add https://github.com/stefanfaur/roach-marketplace --skill brainstorming-stefanfaur

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Jumping straight into implementation without a validated design leads to wasted work, unexamined assumptions, and misaligned features. This Skill enforces a research-first dialogue that turns rough ideas into reviewed, approved design documents before any code is written. ## Core Features & Use Cases - Structured Clarification: Explores project context, then asks one question at a time to pin down purpose, constraints, and success criteria. - Approach Comparison: Proposes 2-3 implementation approaches with trade-offs and a recommendation before settling on a design. - Incremental Design Approval: Presents the design in 200-300 word sections, requiring user approval after each, then writes the spec to thoughts/shared/plans/<domain>/YYYY-MM-DD-<topic>-design.md. - Use Case: Before building a new feature, run this Skill to explore requirements, compare architectures, and produce a reviewed design doc that hands off cleanly to implementation planning. ## Quick Start Ask the AI to brainstorm and design the new feature you have in mind before writing any code.

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 clarify purpose, constraints, and success criteria one question at a time. Propose 2-3 approaches with trade-offs, present the design in small sections for approval, and write the result to a dated design document.

What is the best way to validate a software design with stakeholders?▼

Present the design in sections of 200-300 words and get explicit approval after each section rather than delivering one large document. Always show the full section text in the same message as the approval question so reviewers see exactly what they are confirming.

Does brainstorming apply to small or simple changes?▼

Yes, every project goes through the design process regardless of perceived simplicity, including single-function utilities and config changes. The design can be only a few sentences for simple work, but it must be presented and approved before implementation.

When should a project be decomposed instead of designed directly?▼

Decompose when the request describes multiple independent subsystems that cannot fit a single spec. Identify the independent pieces, their relationships, and build order, then run the normal design flow on the first sub-project.

What happens after the design spec is approved?▼

After the spec passes an inline self-review for placeholders, consistency, scope, and ambiguity, the user reviews the written file. Once approved, the workflow transitions to the writing-plans skill to create a detailed implementation plan.