bmad-planning-orchestrator/skills/bmad-brainstorm/SKILL.md
Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting). Produces a brainstorming-report.md of organized ideas and actionable insights. Operates in three intents: Create (new session), Update (add techniques or deepen coverage), Validate (confirm insights align with project goals). Use when the user says: "brainstorm", "ideate", "generate ideas", "explore options", "SCAMPER", "SWOT analysis", "mind map", "Six Thinking Hats", "5 Whys", "creative session", "what if we", "let's explore", "think through possibilities", "find alternatives", or "problem-solve". This skill PLANS only — it never writes application code or runs tests.
npx skillsauth add aj-geddes/claude-code-bmad-skills bmad-brainstormInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Structured ideation harness for the BMAD planning lifecycle. Produces a
brainstorming-report.md of organized ideas and insights ready to feed downstream
planning skills (product-brief, PRD, architecture).
Ask the user which intent applies — or infer from context:
| Intent | When to use | |--------|-------------| | Create | New brainstorming session on a topic or problem | | Update | Add techniques, deepen coverage, or incorporate new constraints | | Validate | Confirm generated insights align with project goals or decision-log |
| Technique | Best For | Approx Time | |-----------|----------|-------------| | 5 Whys | Root cause analysis | 10-15 min | | SCAMPER | Feature ideation & creative variations | 20-30 min | | Mind Mapping | Idea organization & hierarchy | 15-20 min | | Reverse Brainstorming | Risk and failure-mode identification | 15-20 min | | Six Thinking Hats | Multi-perspective evaluation | 30-45 min | | Starbursting | Question exploration (Who/What/When/Where/Why/How) | 20-30 min | | SWOT Analysis | Strategic positioning | 30-45 min | | Brainwriting | Silent parallel idea generation | 15-20 min |
Use TodoWrite to track each step.
bmad-output/project-context.md and bmad-output/decision-log.md if presenttemplates/brainstorm-session.template.md; save to output folderGenerate SCAMPER prompts for a specific topic:
bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-brainstorm/scripts/scamper-prompts.sh" "your topic"
Generate a SWOT analysis scaffold:
bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-brainstorm/scripts/swot-template.sh" "your subject" > bmad-output/swot-draft.md
All artifacts go under the user-configured output folder (default bmad-output/).
| File | Description |
|------|-------------|
| bmad-output/brainstorming-report.md | Primary output — organized ideas + insights |
| bmad-output/decision-log.md | Append key decisions made during session |
| bmad-output/swot-draft.md | Optional SWOT scaffold (from script) |
Use templates/brainstorm-session.template.md for the report structure.
For sessions covering multiple techniques in parallel, fan out one agent per technique.
Pattern: Fan-Out Ideation
Agents: 2-6 parallel (one per selected technique)
| Agent | Task | Output |
|-------|------|--------|
| Agent 1 | Apply SCAMPER to generate feature variations | bmad-output/brainstorm-scamper.md |
| Agent 2 | Build Mind Map to organize ideas hierarchically | bmad-output/brainstorm-mindmap.md |
| Agent 3 | Reverse Brainstorming — identify failure modes | bmad-output/brainstorm-risks.md |
| Agent 4 | Six Thinking Hats — multi-perspective analysis | bmad-output/brainstorm-hats.md |
| Agent 5 | Starbursting — Who/What/When/Where/Why/How | bmad-output/brainstorm-questions.md |
| Agent 6 | SWOT Analysis — strategic positioning | bmad-output/brainstorm-swot.md |
Coordination:
bmad-output/brainstorm-objective.mdbmad-output/brainstorming-report.mdbmad-output/decision-log.mdExample subagent prompt:
Task: Apply SCAMPER technique
Context: Read bmad-output/brainstorm-objective.md for topic and constraints
Output: Write 15-20 creative variations to bmad-output/brainstorm-scamper.md
Apply each SCAMPER letter systematically. Generate 2-4 ideas per letter.
For each idea: one-sentence description, potential value, innovation level
(incremental / breakthrough). Conclude with your top 3 most promising ideas.
Do not implement anything — ideation output only.
bmad-output/decision-log.md.
Part of the BMAD Planning & Orchestrator plugin — a Claude Code harness for the BMAD Method by the BMAD Code Organization (https://github.com/bmad-code-org/BMAD-METHOD). Implements the spirit of
bmad-brainstorming. All methodology credit belongs to the BMAD Code Organization.
testing
Solutioning-phase UX planning skill (optional; activate when the project has a UI). Produces TWO planning documents: DESIGN.md (the visual system — design tokens, color palette, typography, spacing, component specs, WCAG 2.1 AA contract) and EXPERIENCE.md (user journeys, flow diagrams, screen states, error/empty/loading handling). Use when the user says "design the UX", "create UX planning docs", "define the design system", "map the user flows", "UX for this feature", "wireframe the flows", "what are the user journeys", "accessibility design", "WCAG compliance", "design tokens", "responsive design plan", "mobile-first design", or "create DESIGN.md / EXPERIENCE.md". Runs after architecture is drafted and before stories are created. Supports Create / Update / Validate intents.
testing
Quick Flow lightweight technical specification for small-scope work (1-15 stories). Replaces the full PRD + architecture pair when scope is small and requirements are clear. Produces bmad-output/tech-spec.md as the single planning artifact before story creation. Use when the user says: "write a tech spec", "create a technical specification", "I need a tech spec for this feature", "quick spec", "small project spec", "we don't need a full PRD", "just a tech spec", "spec out this change", "document this feature". QUICK FLOW TRACK ONLY (1-15 stories). If scope grows beyond ~15 stories or involves multiple teams / external integrations at scale, stop and redirect to bmad-prd + bmad-architecture instead — those skills are built for that complexity. Supports three intents: Create (new spec), Update (revise an existing tech-spec.md), Validate (review a draft for completeness against BMAD criteria).
tools
Orchestration handoff bridge: emits and maintains sprint-status.yaml as the project's sequencing system-of-record. Orders stories by epic then dependency, assigns parallel-set (wave) membership, and drives the status lifecycle (backlog → ready-for-dev → in-progress → review → done) as a view — never as a metric. Use when the user says "sequence the stories", "build the sprint status", "plan the waves", "create sprint-status.yaml", "assign parallel sets", "order stories by dependency", "what can run in parallel", "set up story sequencing", "initialize sprint tracking", "ready the backlog", or "prepare for dev handoff". Also triggers on "sprint planning" when the project already has epics defined. SCOPE: SEQUENCING AND ORCHESTRATION ONLY. No velocity, no burndown, no committed points, no coverage metrics. Capacity is expressed as wave width (concurrent story count), not points. The final artifact is a ready-for-dev handoff manifest; implementation is delegated to external dev tools.
development
Distills ANY messy input — brain dump, transcript, long PRD, stakeholder notes, feature request, voice memo — into a tight five-field SPEC.md kernel that any downstream planning skill can consume. The five fields are: Problem, Capabilities, Constraints, Non-Goals, Success Metrics. Use when the user says "create a spec", "write a spec for", "distill this into a spec", "I have a brain dump", "turn this into something structured", "clean up these notes", "make a SPEC from", "I want to define the problem", "help me scope this", "summarize what we're building", "I have a PRD but need a kernel", "what are we actually solving?", or drops raw text/transcript and asks for structure. Also use when starting any new initiative and a clean shared definition is missing.