discover

Convert product ideas into schema-aligned discover-notes.md for downstream specification.

3|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/bpawlakj/ai-devkit --skill discover-bpawlakj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discover
Source: https://github.com/bpawlakj/ai-devkit/tree/main/claude/skills/discover
Command: npx skills add https://github.com/bpawlakj/ai-devkit --skill discover-bpawlakj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It structures an early product discovery conversation so your inputs become schema-aligned docs/discover-notes.md that /product-spec can reliably transform into a full spec, whether you are starting fresh or changing an existing system.

Core Features & Use Cases

  • Greenfield or brownfield discovery: Automatically adapts the question flow based on project markers to handle new products and meaningful system changes.
  • Resumable, phase-based facilitation: Detects prior sessions in docs/discover-notes.md and resumes from the next unfinished phase without replaying completed work.
  • Brownfield inheritance and delta gating: Scans existing artifacts (like docs/product-spec.md, docs/architecture/, and docs/work/) to inherit stable baseline elements and ask only what is changing.
  • Optional reference material scan: Lets you select evidence from docs/reference/ and threads it through phases as check-against context, not silent authority.
  • Safety via schema checkpoints: Follows references/product-spec-schema.md for the required checkpoint format so downstream generation is consistent.

Quick Start

Run the discover skill with your idea inline, for example: /discover a lightweight inventory app that suggests reorder items from current stock.

Frequently Asked Questions about discover

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

FAQPage Schema
How do I elicit product requirements for a new feature idea?

Structured product discovery converts your idea into schema-aligned discover notes using a phase-based facilitation workflow. It guides context detection and schema checkpointing to ensure your inputs become reliable downstream specifications.

What is the best way to document requirements for an existing system change?

Brownfield inheritance scanning extracts stable baseline elements from existing artifacts like product specs and architecture docs. Delta gating then asks only about changing components, avoiding redundant questioning during discovery.

Can I resume product discovery sessions after stopping midway?

Resume handling detects prior sessions in your discover notes file and continues from the next unfinished phase. It avoids replaying completed work, making requirements elicitation fully resumable.

How do I generate a spec from discovery notes without losing context?

Schema checkpointing enforces a consistent format during discover note generation. This structured output allows downstream product-spec generation to reliably transform your elicited requirements.

Do I need reference materials to start the product discovery workflow?

Reference materials are optional during product discovery. You can select evidence from a docs directory to thread through phases as check-against context, but the workflow uses only user-provided content as authoritative input.