brainstorm

Convert ambiguous product ideas into approved written specifications before implementation.

8|1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill brainstorm-joecp17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorm
Source: https://github.com/JoeCP17/LLM-Dot-files/tree/main/codex/skills/brainstorm
Command: npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill brainstorm-joecp17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you turn a rough idea or vague request into a clear, user-approved design and written specification so implementation starts with aligned requirements and reduces rework.

Core Features & Use Cases

  • Hard-gated design-first workflow: blocks any code changes or implementation action until the design is presented and approved.
  • Clarifying questions and requirement refinement: asks one material question at a time to converge on purpose, constraints, non-goals, and success criteria.
  • Approach comparison and recommended design: proposes 2–3 options with trade-offs and a recommendation, then drafts the architecture into a spec.
  • Writes an approved spec to the local specs workspace: outputs a design document to docs/specs/.local/ with a date/topic filename and performs a self-review before handing it back.

Quick Start

Use brainstorm to take my idea for a feature and produce an approved design spec before any implementation begins.

Frequently Asked Questions about brainstorm

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

FAQPage Schema
How do I turn a rough product idea into an approved design spec before coding?

To turn a rough idea into an approved design spec, use a hard-gated workflow that asks incremental clarifying questions, proposes multiple approaches, and writes the final architecture to a local spec file before any implementation begins.

What is a hard-gate workflow for requirement clarification and architecture design?

A hard-gate workflow for requirement clarification blocks any code changes until a design is presented and approved, ensuring implementation starts with aligned requirements and reducing rework.

How do I draft architecture and acceptance criteria for scoped engineering changes?

To draft architecture and acceptance criteria, the workflow proposes 2-3 design options with trade-offs, recommends an approach, performs a self-review, and outputs a written specification document.

Can I write approved specification documents directly to my local project specs directory?

Yes, the approved specification document is written directly to the local specs workspace at docs/specs/.local/ with a date and topic filename for immediate project integration.

Does the spec writing process propose multiple approaches with trade-offs?

Yes, the spec writing process proposes 2-3 design options with trade-offs and a recommendation to help you choose the best architecture before drafting the final requirements.

What are the limitations of enforcing a hard gate against code changes during brainstorming?

The limitation of a hard gate against code changes is that it strictly prevents any implementation actions until the design is fully approved, which may slow down rapid prototyping for highly experimental features.