Use when the user asks to "test a hypothesis", "validate assumptions through delivery", "run experiment-driven project", "design build-measure-learn cycles", "validate project assumptions", or mentions hypothesis-driven delivery, HDD, validated learning, experiment design, build-measure-learn. Triggers on: converts assumptions into testable hypotheses, designs minimum viable experiments, facilitates pivot-or-persevere decisions, documents validated learning, ranks hypotheses by risk and impact.
The canonical home for this skill is apex-hypothesis-driven-delivery in JaviMontano/mao-discovery-framework
TL;DR: Applies hypothesis-driven delivery to project decisions, transforming assumptions into testable hypotheses with clear success/failure criteria. Uses build-measure-learn cycles to validate project assumptions before committing full investment, reducing risk through validated learning.
Toda decisión de proyecto descansa sobre hipótesis. "Los usuarios adoptarán la nueva herramienta" es una hipótesis, no un hecho. HDD hace explícitas estas hipótesis, las ordena por riesgo, y las valida con el mínimo esfuerzo posible. Invertir millones sin validar hipótesis críticas es esperanza, no gestión.
/pm:hypothesis-driven-delivery $PROJECT_NAME --extract-from=assumptions
/pm:hypothesis-driven-delivery $PROJECT_NAME --hypothesis="Users will adopt tool X" --experiment=pilot
/pm:hypothesis-driven-delivery $PROJECT_NAME --rank-by=risk-impact --top=5Parameters:
| Parameter | Required | Description |
|---|---|---|
$PROJECT_NAME | Yes | Target project identifier |
--extract-from | No | Source for hypothesis extraction (assumptions / risks / charter) |
--hypothesis | No | Specific hypothesis to test |
--experiment | No | Experiment type (pilot / ab-test / survey / prototype) |
--rank-by | No | Ranking criterion (risk-impact / cost / urgency) |
{TIPO_PROYECTO} variants:
assumption-log — identify assumptions already documented that need validation [PLAN]*risk-register* — high-probability risks often contain untested hypotheses [PLAN]Good Hypothesis-Driven Delivery:
| Attribute | Value |
|---|---|
| Hypothesis format | "We believe [X]. We will know when [metric] reaches [target] by [date]" |
| Ranking | 8 hypotheses ranked by risk x impact; top 3 tested first [METRIC] |
| Experiment design | 2-week pilot with 15 users, quantitative success criteria [SCHEDULE] |
| Success criteria | Defined before experiment: adoption rate above 60% in 2 weeks [METRIC] |
| Decision | Pivot decision based on 42% adoption result — redesign onboarding [PLAN] |
Bad Hypothesis-Driven Delivery: "We tested the tool and people seemed to like it." — No structured hypothesis, no pre-defined success criteria, no quantitative measurement, no clear decision framework. Result: confirmation bias disguised as validated learning.
| Resource | When to read | Location |
|---|---|---|
| Body of Knowledge | Before starting to understand standards and frameworks | references/body-of-knowledge.md |
| State of the Art | When benchmarking against industry trends | references/state-of-the-art.md |
| Knowledge Graph | To understand skill dependencies and data flow | references/knowledge-graph.mmd |
| Use Case Prompts | For specific scenarios and prompt templates | prompts/use-case-prompts.md |
| Metaprompts | To enhance output quality and reduce bias | prompts/metaprompts.md |
| Sample Output | Reference for deliverable format and structure | examples/sample-output.md |
Designs Build-Measure-Learn experiments. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Formulates testable hypotheses. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Builds measurement frameworks for hypothesis validation. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Advises on pivot or persevere decisions based on experiment results. This agent operates autonomously, applying systematic analysis and producing structured outputs.
0a5159a
Canonical home
since Aug 28, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.