pbs-discover

Interviews an unshaped idea into a verdict and design document for pbs-plan.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Peterson-Benhame/agent-skills --skill pbs-discover-peterson-benhame
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pbs-discover
Source: https://github.com/Peterson-Benhame/agent-skills/tree/main/packages/skills-catalog/skills/%28development%29/pbs-discover
Command: npx skills add https://github.com/Peterson-Benhame/agent-skills --skill pbs-discover-peterson-benhame

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often jump from a vague idea straight to implementation, converging on the first solution proposed without examining the problem, the evidence, or cheaper alternatives. This Skill runs a structured discovery interview that turns an unshaped idea into a confirmed verdict and a design document with literal decisions. ## Core Features & Use Cases - Structured Discovery Interview: Walks through Situation, Problem, Evidence, Journey, and Verdict phases, asking only answerable questions with recommended answers. - Two-Shape Decision Framework: Compares a lighter and a heavier technical shape against the actual repository, with explicit conditions for when each wins. - Design Document Output: Produces a .design/<name>.md file with Decisions, Roadmap, RFC/spike/design handoffs, and Sources that feeds directly into pbs-plan. - Use Case: When a stakeholder says "we should add caching" or "should we build this feature", run this Skill to recover the underlying problem, measure its cost, reach a build/not-build verdict, and record concrete decisions before any planning begins. ## Quick Start Ask the agent to run pbs-discover on your idea, for example: "Use pbs-discover to research whether we should build a notification system for this project."

Frequently Asked Questions about pbs-discover

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

FAQPage Schema
How do I run a product discovery before planning a feature?

Invoke pbs-discover with the unshaped idea. It interviews you through Situation, Problem, Evidence, and Verdict phases, then writes a design document with decisions that pbs-plan consumes for implementation planning.

What is the difference between pbs-discover and pbs-plan?

pbs-discover decides whether and what to build, producing a verdict and design document. pbs-plan takes that settled shape and plans the implementation against the code. Use pbs-discover only when the shape is not yet decided.

When should I not use a discovery interview?

Skip discovery when the change is cheap to reverse, has a small blast radius, and nobody disagrees. Also skip it when the shape is already decided, in which case go directly to pbs-plan.

What output does pbs-discover produce?

It writes a design document at .design/<name>.md containing Situation, Problem, Evidence, Journey, Verdict, Shape, Roadmap, Decisions, and handoff sections for RFCs, spikes, and design work.

Can pbs-discover recommend not building something?

Yes. The verdict has four real outcomes: build, build something smaller or different, not now, and do not build. Declining carries its own argued case in the same units as the cost of building.