mcpField
P
product-discovery

product-discovery

github.com/magnus919Productivity172106 installsUpdated 1d ago
Repository

About product-discovery

A product discovery skill that guides teams from customer problems, vague ideas, or existing drafts through interviews, synthesis, and specification validation. It separates customer evidence from internal requests and provides templates for tracking gaps, conflicts, and interpretation decisions.

Key features

  1. 01Choose a discovery path by decision stage
  2. 02Plan interview participants and question sequence
  3. 03Assess problem evidence and distinguish evidence types
  4. 04Turn interview notes into structured specifications
  5. 05Identify requirement conflicts and unresolved gaps
  6. 06Use discovery and interpretation-log templates

Use cases

  1. 01Assess whether an external customer problem warrants investment
  2. 02Choose interview participants and questions for a vague idea
  3. 03Turn interview notes into a SPEC.md
  4. 04Validate stakeholder interpretations in a draft specification

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/magnus919/agent-skills --skill product-discovery

After installing, type/product-discoveryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
evals/
artifact-first-rubric-review.md
artifact-first-run.json
artifact-first-validation.md
customer-problem-review.md
evals.json
trigger-queries.json
references/
ai-conducted-discovery.md
artifact-first-interview.md
conflict-resolution.md
customer-problem-discovery.md
gap-detection.md
power-dynamics.md
question-patterns.md
stakeholder-mapping.md
time-constrained-discovery.md
transcript-to-spec.md
templates/
customer-evidence-ledger.md
discovery-plan.md
distillation-worksheet.md
gap-register.md
interpretation-log.md
interview-guide.md

Details

From the project README

Product Discovery — Stakeholder Map

Choose the entry by the decision at stake. For an existing draft, preserve the artifact-first entry below. For external demand or problem uncertainty, load customer/problem discovery before turning an idea into requirements. For internal requirements, begin with stakeholder mapping:

ReferenceLoad whenFile
Stakeholder Mapping & SequencingYou need to decide who to interview and in what orderreferences/stakeholder-mapping.md
Interview Protocol DesignYou're designing a question stack for a specific stakeholder typereferences/question-patterns.md
Gap Detection TechniquesYou're preparing to recognize what stakeholders don't sayreferences/gap-detection.md

Pipeline: Phase 0 — Discovery

RAW NEED → [MAP] → [INTERVIEW] → [SYNTHESIZE] → [DISTILL] → [VALIDATE] → SPEC.md
              |           |              |            |            |
         Who to       What to        Resolve      Convert to   Stakeholder
         talk to      ask            conflicts    structured   review

Load the reference for the phase you're entering.

Core principles

  • Closed questions confirm what you already think; open questions discover what you didn't know to ask. If the answer can be "yes" or "no," you're validating, not discovering.
  • Knowledge holders come first; authority holders validate — they don't originate. The person who knows the problem is not the same person who approves the budget.
  • Conflicts are almost never about what they appear to be. Surface disagreements are proxies for unstated differences in assumptions, risk tolerance, or incentives.
  • Every weasel word represents a gap. "Probably," "ideally," "eventually" — each is a known issue the stakeholder hasn't committed to addressing.

Quick Start — Where to Enter

You have thisStart here
A PRD, brief, or spec to grill with its authorLoad references/artifact-first-interview.md — ask one consequential question at a time, then patch only affected passages
Unproven external customer problem or demandLoad references/customer-problem-discovery.md and use templates/customer-evidence-ledger.md — assess the problem before requirements
A vague idea or problem spaceLoad references/stakeholder-mapping.md — identify who to interview
An interview scheduled with no protocolLoad references/question-patterns.md and references/gap-detection.md — design your question stack
Raw interview notes from one or more sessionsLoad references/transcript-to-spec.md — distill into structured spec components
A draft spec that needs stakeholder verificationLoad references/transcript-to-spec.md (Interpretation Audit Trail section) — run the validation loop
Stakeholders who disagree on requirementsLoad references/conflict-resolution.md — classify and resolve before spec
Limited time with a stakeholderLoad references/time-constrained-discovery.md — maximize signal in minimal time
An AI agent conducting interviewsLoad references/ai-conducted-discovery.md — account for sycophancy and trust dynamics

Done with discovery? Use product-methodology to choose scope, then product-design-and-ux to define user-facing behavior. Jump to the Is Discovery Complete? checklist at the bottom.

Artifact-first review

When the user brings a draft to interrogate, load artifact-first interviewing. Read the artifact before asking; choose one decision-bearing question, wait for the answer, then adapt. Reuse the gap register for assumptions and unresolved conflicts, and the interpretation log for decisions and patch provenance. Stop when the user stops, the agreed question budget expires, or no consequential unresolved decision remains. Return a targeted proposed patch and explicitly unverified gaps. This bounded review does not satisfy the full-discovery checklist below.

Customer/problem discovery

Keep internal requests separate from external customer evidence. Record stated preference, reported past behavior, observed behavior, and costly commitment as distinct evidence classes; enthusiasm is not validation. Assess problem severity, frequency, workarounds, segment differences, and contradictions before specifying a solution. A real problem does not establish solution value, usability, feasibility, or business viability. Route experiment design to product-experimentation, measurement to product-analytics-and-measurement, product choices to product-strategy, and economics to financial-modeling (AI workflow economics to ai-operating-economics). Stop, defer, or narrow when evidence does not justify the next bounded investment; do not manufacture requirements to keep a pipeline moving.

Load references/customer-problem-discovery.md for the workflow and evidence limits; use templates/customer-evidence-ledger.md when recording customer claims or a continue/narrow/defer/stop recommendation. This path ends with an evidence-backed investment recommendation and gaps, not automatically a SPEC.md. Existing draft review remains one question at a time and never establishes external validation.

When not to use

Route personal routines and life priorities to daily-life-discovery, general research plans to research-methodology, and execution sequencing for settled requirements to implementation-planning. General stakeholder research for a product still uses this skill’s existing MAP/INTERVIEW workflow; do not force it into draft review.

Trigger Conditions

Load this skill when:

  • You need to know whether an external customer problem warrants investment
  • You want to grill a PRD, poke holes in a proposal, or be interviewed about a draft
  • You're starting product discovery for a new feature or project
  • You have a vague idea that needs to become a structured specification
  • You need to interview stakeholders but don't have a protocol
  • You have raw interview notes that need to become a SPEC.md
  • You're about to enter Phase 1 (SPECIFY) of SDD and need upstream input
  • You're evaluating whether you've done enough discovery work

Loading Guide

PhaseLoad WhenFile
MAPYou need to identify who to interview, in what order, and how to find the right stakeholdersreferences/stakeholder-mapping.md
INTERVIEWYou're about to conduct stakeholder interviews and need question patterns, gap detection, and conflict handlingreferences/question-patterns.md + references/gap-detection.md + references/conflict-resolution.md
SYNTHESIZEYou have raw interview notes and need to identify conflicts, risks, and gaps before distillationreferences/conflict-resolution.md
DISTILLYou need to transform interview notes into structured SPEC.md with ACs, edge cases, and NFRsreferences/transcript-to-spec.md
VALIDATEYou have a draft spec and need to verify interpretations with stakeholdersreferences/transcript-to-spec.md (Interpretation Audit Trail section)

Cross-Cutting Concerns

These dimensions apply across all phases. Load when relevant:

ConcernLoad whenFile
AI-conducted discoveryAn AI agent is conducting discovery interviewsreferences/ai-conducted-discovery.md
Power dynamicsStakeholders span multiple organizational levels; hierarchy may distort responsesreferences/power-dynamics.md
Time constraintsStakeholder time is limited; need maximum signal extractionreferences/time-constrained-discovery.md

Templates

TemplatePipeline PhaseLoad whenFile
Discovery PlanMAPYou need to structure the full discovery effort — stakeholder map, interview schedule, timelinetemplates/discovery-plan.md
Interview GuideINTERVIEWYou need a structured question stack for an interview sessiontemplates/interview-guide.md
Distillation WorksheetDISTILLYou're transforming raw notes into structured spec componentstemplates/distillation-worksheet.md
Gap RegisterSYNTHESIZEYou need to track unresolved gaps, deferred decisions, and open questions across interviewstemplates/gap-register.md
Interpretation LogDISTILL → VALIDATEYou need to track every translation from stakeholder language to spec languagetemplates/interpretation-log.md

Quick Reference: Is Discovery Complete?

For full stakeholder discovery before handing off to SDD Phase 1 (SPECIFY), use this checklist. A stopped artifact-first review reports remaining gaps instead of declaring these complete:

  • All stakeholder types interviewed (knowledge holders, authority holders, affected parties, implementation knowers)?
  • At least 3 independent sources for every requirement?
  • Abstract nouns decomposed into measurable thresholds?
  • Conflicts resolved or documented with decision-maker identified?
  • Edge cases extracted from stakeholder anecdotes?
  • Every AC classified: SAID / IMPLIED / INTERPRETED / INFERRED?
  • HIGH-risk interpretations identified and flagged for validation?
  • Gaps, deferred decisions, and avoided topics documented?
  • Stakeholder validation loop completed?
  • Interpretation audit trail preserved for handoff?

Comments

Markdown supported