brainstorm

Brainstorm

A Claude Code plugin marketplace for turning fuzzy ideas into concrete design docs.

Inspired by Jesse Vincent's AI workflow.

Installation

Add this marketplace to Claude Code:

/plugin marketplace add thepushkarp/brainstorm-plan

Then install the brainstorm plugin:

/plugin install brainstorm@brainstorm-plan

Commands

/brainstorm [topic]

Interactive Q&A to refine an idea into a design specification.

Features:

• Explores existing codebase for context (or starts fresh for new projects)
• Asks one question at a time (prefers multiple choice)
• Presents design in 200-300 word sections for approval
• Saves to docs/brainstorms/<topic>.md

Usage:

/brainstorm                           # Start interactively
/brainstorm user authentication       # Start with an initial idea

Typical Workflow

1. Brainstorm - /brainstorm to explore and refine your idea
2. Implement - Use Claude Code's (or Codex's) built-in plan mode, using the saved design doc as reference

Output Directories

• Design docs: docs/brainstorms/

Release / Maintenance

Before publishing changes:

claude plugin validate .
claude plugin validate plugins/brainstorm

Publish updates:

git add .
git commit -m "chore: <describe plugin update>"
git push origin main

After pushing marketplace/plugin changes, consumers should refresh and reinstall/update:

/plugin marketplace update brainstorm-plan
/plugin update brainstorm@brainstorm-plan

License

MIT