Brainstorm Plan

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

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

/brainstorm-plan [design-doc-path]

Create a detailed implementation plan from a design doc or conversation.

Features:

• Written for engineers with zero codebase context
• Bite-sized tasks with file references, tests, and commit messages
• Emphasizes DRY, YAGNI, TDD, frequent commits
• Saves to docs/plans/<topic>-implementation.md

Usage:

/brainstorm-plan                                          # From conversation context
/brainstorm-plan docs/brainstorms/user-authentication.md  # From specific design doc

Typical Workflow

1. Brainstorm - /brainstorm to explore and refine your idea
2. Plan - /brainstorm-plan to create detailed implementation tasks
3. Implement - Use Claude Code's plan mode with the written plan as reference

Output Directories

• Design docs: docs/brainstorms/
• Implementation plans: docs/plans/

License

MIT