brainstorming

Guides collaborative dialogue to turn ideas into approved design documents before implementation.

1|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill brainstorming-williamthorsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/brainstorming
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill brainstorming-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump straight into coding without clarifying requirements, leading to wasted work on misunderstood features. This Skill enforces a structured discovery process that explores user intent, constraints, and design trade-offs 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. - Design Exploration: Proposes 2-3 approaches with trade-offs and presents design sections incrementally for user approval. - Design Documentation: Writes the validated design to docs/plans/YYYY-MM-DD-<topic>-design.md, commits it to git, and hands off to the writing-plans skill. - Use Case: Before building a new feature, an agent uses this Skill to interview the user, compare architectural options, and produce an approved design document that anchors the implementation plan. ## Quick Start Ask the agent 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 turn a feature idea into a design document with an AI agent?

Invoke the brainstorming process before any coding: the agent explores your project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and writes the approved design to docs/plans as a dated markdown file.

What should happen before writing code for a new feature?

Requirements and design should be validated first. This Skill enforces a hard gate: no implementation skill, code, or scaffolding is allowed until a design has been presented section by section and explicitly approved by the user.

Does the brainstorming process apply to small or simple changes?

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

What happens after the design is approved?

The validated design is saved to docs/plans/YYYY-MM-DD-<topic>-design.md and committed to git. The only permitted next step is the writing-plans skill, which creates the implementation plan; other implementation skills are explicitly excluded.

When should I not use a structured brainstorming workflow?

The Skill itself mandates use before any creative work, so it is not suited for purely mechanical tasks with no design decisions, such as running existing scripts or applying already-approved plans. Those belong to implementation-phase skills.