epic-hypothesis

Frames an epic as a falsifiable hypothesis with confirming signals, kill thresholds, and a cheapest validation test.

Updated Jul 21, 2026
One-click install
npx skills add https://github.com/BrunoL28/product-onboarding-skill --skill epic-hypothesis-brunol28
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: epic-hypothesis
Source: https://github.com/BrunoL28/product-onboarding-skill/tree/main/skills/epic-hypothesis
Command: npx skills add https://github.com/BrunoL28/product-onboarding-skill --skill epic-hypothesis-brunol28

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams write epics as plans and commitments, so weak ideas get built because nobody ever wrote down the result that would make them stop. This Skill turns an epic into a bet the team can actually lose: a target user, a behaviour change with a baseline, a confirming signal, a falsifying signal, and the cheapest test that could produce either. ## Core Features & Use Cases - Falsifiable hypothesis framing: Renders the epic in both If/Then and Gothelf Lean UX grammars, then forces a numeric falsifying threshold with a named owner who can act on it. - Signal design with guardrails: Builds a signal table (Measure, Baseline, Source, Confirm, Falsify, Window) that rejects adoption metrics, derives the window from the user journey rather than the sprint, and requires at least one guardrail metric. - Cheapest-test selection: Climbs a validation ladder from existing data queries up to an instrumented thin slice, ruling out cheaper rungs explicitly. - Use Case: Before splitting or prioritising an epic, a product manager runs this Skill to produce an Epic Hypothesis card to paste into Jira, ADO, or Linear, including a pre-committed decision rule and a read-out date. ## Quick Start Frame this epic as a falsifiable hypothesis with confirming and falsifying signals, a decision rule, and the cheapest test that could prove it wrong.

Frequently Asked Questions about epic-hypothesis

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

FAQPage Schema
How do I write a falsifiable hypothesis for a product epic?▼

State the target user and the behaviour you expect to change, then define a numeric confirming signal and a numeric falsifying signal with a baseline, source, and window. Pre-commit a decision rule naming who can act on the falsifying branch before any data arrives.

What is the difference between a hypothesis and a PRD or business case?▼

A hypothesis states what you expect to learn and what result would stop the work, while a PRD lists requirements and a business case estimates ROI. This Skill explicitly excludes scope, acceptance criteria, and effort estimates, which belong to later steps.

Why are adoption metrics rejected as hypothesis signals?▼

Adoption metrics like screen views only move because the feature shipped, so they measure shipping rather than behaviour change. A valid signal is a behaviour that could have changed some other way, such as support calls that did not happen.

When should I use an epic hypothesis instead of going straight to epic breakdown?▼

Use it before prioritisation or breakdown whenever the epic rests on an untested belief about user behaviour. If the outcome, persona, and baseline are already settled upstream, the Skill collapses to a draft plus the falsifier and cheapest-test questions.

What happens if the team cannot name a kill threshold owner?▼

The hypothesis is marked provisional with a banner on the card, and naming the owner goes into Assumptions to Validate. The Skill never invents a kill threshold or assigns a decision to someone who has not agreed to it.