Help us improve
Share bugs, ideas, or general feedback.
From dev-skills
Validates product ideas before engineering investment by assessing risks, unknowns, and designing cheap experiments.
npx claudepluginhub teambrilliant/marketplace --plugin dev-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/dev-skills:product-discoveryThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Figure out whether an idea is worth building before you commit engineering time. The goal is sufficient evidence that the solution will work — not certainty, but enough to bet responsibly.
Guides technical evaluation of code review feedback: read fully, restate for understanding, verify against codebase, respond with reasoning or pushback before implementing.
Share bugs, ideas, or general feedback.
Figure out whether an idea is worth building before you commit engineering time. The goal is sufficient evidence that the solution will work — not certainty, but enough to bet responsibly.
70-90% of features built without validation fail to deliver business results. Discovery exists to catch the failures early and cheap, so engineering investment goes toward ideas with real evidence behind them.
Every idea tested in discovery should cost at least one order of magnitude less than building the real thing. If engineering a feature takes 4 weeks, discovery should take days. If it takes months, discovery should take weeks.
Get clarity on what's being proposed. Read any existing artifacts — shaped work documents, PRDs, feature requests, Slack threads, customer feedback. If working in a codebase, check CLAUDE.md and related code for context.
Restate the idea as a problem to solve and a desired outcome:
If the input is a solution ("build a self-service portal"), reverse-engineer it: what problem does the portal solve? ("Partners can't onboard without calling support, costing us $X per onboarding")
Every product idea carries four types of risk. Rate each low / medium / high based on what you know right now.
Value risk — Will customers choose to use this?
Usability risk — Can users figure out how to use it?
Feasibility risk — Can we build and scale this?
Viability risk — Does this work for the business?
The risks rated medium or high are what discovery needs to address. Low risks don't need experiments — move on.
For each medium/high risk, articulate the specific uncertainty as a testable hypothesis:
We believe [specific assumption].
We'll know we're right if [observable evidence].
We'll know we're wrong if [observable evidence].
Be honest about what you can't know without investigation. Common unknowns:
| Risk | Common unknowns |
|---|---|
| Value | Will customers actually switch? Is the pain big enough? |
| Usability | Can users complete the flow without help? Where do they get stuck? |
| Feasibility | Can we hit the performance target? How long will integration take? |
| Viability | Will legal approve this? Can support handle the volume? |
For each hypothesis, design the cheapest experiment that produces evidence. Match the experiment type to the risk:
Value experiments (will they want it?):
Usability experiments (can they use it?):
Feasibility experiments (can we build it?):
Viability experiments (does it work for the business?):
Choosing the right experiment:
Each experiment needs a clear decision point — what result means "proceed" vs "pivot" vs "stop"?
### Gate: [hypothesis being tested]
Experiment: [what you'll do]
Timeline: [days/weeks]
Proceed if: [specific evidence threshold — e.g., "4 of 5 users complete the flow without help"]
Pivot if: [evidence suggests a different approach — e.g., "users want the outcome but not this method"]
Stop if: [evidence kills the idea — e.g., "0 of 10 customers express interest in the problem"]
Evidence gates protect the team from two failure modes:
Output a structured plan. Save to thoughts/research/YYYY-MM-DD-discovery-[descriptive-name].md.
# Discovery: [idea name]
## Problem & Desired Outcome
**Problem:** [what's broken]
**Outcome:** [measurable success]
**Origin:** [where this idea came from — customer request, data insight, stakeholder ask, etc.]
## Risk Assessment
| Risk | Level | Key uncertainty |
|------|-------|----------------|
| Value | [L/M/H] | [what we don't know] |
| Usability | [L/M/H] | [what we don't know] |
| Feasibility | [L/M/H] | [what we don't know] |
| Viability | [L/M/H] | [what we don't know] |
## Hypotheses
1. [We believe X. Evidence for: Y. Evidence against: Z.]
2. [...]
## Experiments
### Experiment 1: [name]
- **Tests:** [which hypothesis]
- **Method:** [what you'll do]
- **Timeline:** [how long]
- **Cost:** [effort level — hours/days]
- **Gate:** Proceed if [X]. Pivot if [Y]. Stop if [Z].
### Experiment 2: [name]
[same structure]
## Sequence
[Which experiments to run first, which can run in parallel, dependencies between them]
## What Happens Next
- **If discovery succeeds:** Hand off to `/dev-skills:shaping-work` for detailed work definition
- **If discovery says pivot:** [what the alternative direction looks like]
- **If discovery says stop:** [document what we learned for future reference]
product-thinker → product-discovery → shaping-work → implementation-planning
"should we?" "will it work?" "what exactly?" "how technically?"
If someone brings a raw idea, suggest starting with product-thinker. If they have a clear idea but high uncertainty, this is the right skill. If the idea is low-risk and well-understood, skip straight to shaping-work.
For established companies with existing customers and revenue: experiments must protect the company's revenue, reputation, customers, and colleagues. When testing ideas that could affect real users, use conservative techniques — smaller sample sizes, internal users first, feature flags. The experiments are essential, but run them responsibly.