discovery

Convert context reports and ambiguous product requests into testable specifications with Gherkin acceptance criteria.

8|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/ddobrin/plan-skills --skill discovery-ddobrin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discovery
Source: https://github.com/ddobrin/plan-skills/tree/main/plugins/orchestrator/skills/discovery
Command: npx skills add https://github.com/ddobrin/plan-skills --skill discovery-ddobrin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Discovery converts an existing context report and an ambiguous product request into a rigorous, testable specification before planning or implementation begins.

Core Features & Use Cases

  • Context-driven specification: Uses research findings as the foundation for defining scope, requirements, constraints, and measurable outcomes.
  • Adversarial validation: Routes the specification through a spec-validator gate and requires confirmed findings to be resolved before advancement.
  • Use Case: When a research report exists but the desired feature remains underspecified, use Discovery to question assumptions, produce Gherkin acceptance criteria, and record a validated milestone specification.

Quick Start

Use the discovery skill with the existing context report to create and validate a testable specification for the requested milestone.

Frequently Asked Questions about discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn an ambiguous product request into a testable specification?

To convert an ambiguous product request into a testable specification, provide an existing context report to the discovery skill. It applies product-owner elicitation and adversarial spec validation to produce rigorous, testable requirements.

How do I generate Gherkin acceptance criteria from a context report for milestone planning?

Generating Gherkin acceptance criteria from a context report involves questioning assumptions and defining scope based on research findings. The discovery process records a validated milestone specification by requiring confirmed findings to be resolved before advancement.

What is adversarial spec validation and when do I need it for product specification?

Adversarial spec validation is a gate that routes a product specification through a spec-validator to question assumptions and resolve confirmed findings. You need it for complex feature work, bug fixes, and refactors requiring product clarification before architectural planning.

Do I need a context report before starting product discovery and requirements definition?

Yes, you need a context report before starting product discovery. The discovery process uses an existing context report as the foundation for defining scope, constraints, and measurable outcomes before planning or implementation begins.

Can I use spec validation for complex feature work and refactors that need product clarification?

Yes, you can use spec validation for complex feature work, bug fixes, and refactors that require product clarification. It applies product-owner elicitation to question assumptions before architectural planning or implementation begins.