product-brainstorm
Skill2 starsChanged 2 months agoMITView on GitHub
Structured, adversarial brainstorm for a product or business decision
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Before brainstorming, you should:
- Distinctive: line 55
Use web search (or Perplexity, if available) to research benchmarks, market trends, and similar use cases.
- Distinctive: line 56
Use Context7 to check how other companies/products solved similar problems.
- Very specific: line 58
Check COMPETITIVE_LANDSCAPE.md and CUSTOMER_PERSONAS.md to validate fit.
- Distinctive: line 71
Don't: agree quickly without questioning, accept the first solution as final, ignore real constraints, make assumptions without validating …
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Product Brainstorm
This skill runs a structured brainstorming session for a product, feature, or business decision.
The user's request should name the topic — a product idea, a feature, or a business/technical decision with business impact. If it's too vague to work with ("brainstorm something"), ask what problem or opportunity is being explored before proceeding.
Phase 1: Context
Before brainstorming, you should:
- Read the relevant master docs (if they exist):
docs/business-context/PRODUCT_STRATEGY.md,docs/business-context/CUSTOMER_PERSONAS.md,docs/business-context/COMPETITIVE_LANDSCAPE.md, and any project PRD. - Understand the topic: is this a new product? A new feature? A technical decision with business impact? A strategic pivot?
- Ask the human for initial context: What problem are we trying to solve? What triggered this discussion (customer pain, opportunity, competition)? Are there known constraints (time, budget, technical resources)? How mature is this idea (early, half-formed, nearly ready)?
Phase 2: Divergent exploration
Your job here is to expand the thinking:
Socratic questioning — ask 5-7 provocative questions that challenge assumptions: "Why solve this now?" "What if we do nothing — what's the opportunity cost?" "Who else has tried this, and why did they succeed or fail?" "What's the riskiest bet here?" "How does this connect to the long-term vision?"
Generate alternatives — for the topic, produce at least 3 different approaches, each with: description, 3-5 pros, 3-5 cons, estimated effort (High/Medium/Low), estimated impact (High/Medium/Low), key risks, and the assumptions that need to hold for it to work.
Trade-off analysis — for each alternative, map trade-offs across dimensions like speed vs. quality, scope vs. depth, innovation vs. predictability, cost vs. differentiation, short-term vs. long-term.
Stakeholder analysis — for each alternative, consider impact on customers/users, the engineering team (implementation complexity), the business team (goal alignment), and partners/integrations (external dependencies).
Phase 3: Structured convergence
Decision matrix: build a comparison across criteria such as strategic alignment, technical feasibility, customer impact, expected ROI, and delivery speed. Ask the human which weights matter for this decision.
Risk analysis: for the top 2-3 alternatives, assess technical risk, market risk, operational risk, and strategic risk.
"What if...?" scenarios: explore extremes — half the time, double the budget, a competitor ships this tomorrow, this fails completely.
Phase 4: Grounded recommendation
- Synthesize what emerged: summarize the key insights, highlight patterns.
- Make a recommendation: which alternative, why (grounded in the discussion), and what the next actions are.
- Identify information gaps: what still needs validating, what research/experiments should happen next.
Phase 5: Documentation
Save the session to docs/business-context/brainstorm/<topic-slug>-<YYYY-MM-DD>.md, containing: context, each alternative explored (with the structure above), the trade-off comparison, the risk matrix, the scenarios explored, the recommendation with its rationale and key assumptions, next steps, open questions, and the main learnings from the session.
⛔ After documenting the session, stop and ask the human for feedback. Don't automatically move on to implementation or PRD creation — wait for the human to decide the next step.
Tools
During brainstorming, you can and should:
- Use web search (or Perplexity, if available) to research benchmarks, market trends, and similar use cases.
- Use Context7 to check how other companies/products solved similar problems.
- Consult the master docs to stay strategically aligned.
- Check
COMPETITIVE_LANDSCAPE.mdandCUSTOMER_PERSONAS.mdto validate fit.
Operating principles
- Be provocative, not agreeable — challenge ideas, including the human's.
- Question assumptions — "why do we assume that?"
- Present counter-arguments — for every pro, show a con.
- Force prioritization — "if you could only do one, which would it be?"
- Validate with data, not just intuition, when possible.
- Think in extremes — explore both optimistic and pessimistic scenarios.
- Connect to context — always reference the master docs and strategy.
- Document the reasoning — the "why" matters more than the "what".
Don't: agree quickly without questioning, accept the first solution as final, ignore real constraints, make assumptions without validating them, or skip documenting the session.
Fits into the rest of the pipeline as
product-brainstorm "add real-time notifications" # structured exploration → decision
product-collect "implement push notifications via WebSockets" # if we proceed, collect detailed requirements
product-validate "notifications against architecture" # validate against master docs
product-spec "PRD: notification system" # write the spec
engineer-context feat/real-time-notifications # start implementation
engineer-architecture feat/real-time-notifications # design itIn this repository31 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- bootstrap-business-docsSkill
- bootstrap-indexSkill
- bootstrap-tech-docsSkill
- engineer-adrSkill
- engineer-architectureSkill
- engineer-bumpSkill
- engineer-contextSkill
- engineer-coverageSkill
- engineer-discoverSkill
- engineer-doctorSkill
- engineer-planSkill
- engineer-pre-prSkill
- engineer-prSkill
- engineer-reviewSkill
- engineer-sync-docsSkill
- engineer-validateSkill
- engineer-workSkill
- meta-create-agentSkill
- meta-preferencesSkill
- product-collectSkill
- product-quick-specSkill
- product-refineSkill
- product-specSkill
- product-sync-githubSkill
- product-validateSkill
- python-developerSkill
- typescript-developerSkill
- warm-upSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

