Hypothesis canvas skill

The hypothesis canvas is the central planning artifact in Lean UX.

by wondelai·MIT license·★ 2,235 Stars on the repo·GitHub ↗

Use now

Files of Hypothesis canvas

wondelai/main1 file
hypothesis-canvas.md
Show the full text250 lines

Hypothesis Canvas

The hypothesis canvas is the central planning artifact in Lean UX. It transforms vague product ideas into structured, testable predictions. Every design initiative should start here, not in a wireframing tool.

The Lean UX Hypothesis Format

The standard hypothesis statement links four elements into a single testable prediction:

We believe [outcome]
will happen if [persona]
achieves [action]
with [feature].
Breaking Down the Components
Component Definition Example
Outcome The measurable business or user result you expect "A 15% increase in trial-to-paid conversion"
Persona The specific user segment the hypothesis targets "First-time project managers using our free tier"
Action The behavior you expect users to perform "Complete the guided project setup wizard within the first session"
Feature The design change or product element that enables the action "A 3-step interactive setup wizard on the dashboard"
Complete Hypothesis Examples

E-commerce checkout redesign: "We believe cart abandonment will drop by 20% if returning shoppers can complete checkout in under 60 seconds with a one-click reorder button on the product page."

SaaS onboarding: "We believe 7-day retention will increase by 25% if new users who sign up via the marketing site achieve their first successful data import within 10 minutes with an auto-mapping CSV import tool."

Internal tools: "We believe support ticket resolution time will decrease by 30% if support agents can view the full customer timeline without switching tabs with a unified customer context panel in the ticket view."

Mobile app engagement: "We believe weekly active usage will increase by 40% if casual fitness users log at least 3 workouts in their first week with a simplified one-tap workout logging feature."

Assumption Prioritization Matrix

Before writing hypotheses, the team must surface and prioritize assumptions. The prioritization matrix plots assumptions on two axes.

The Two Axes
Axis Definition Scale
Risk How damaging is it if this assumption is wrong? Low risk (minor inconvenience) to High risk (project failure)
Uncertainty How confident are we that this assumption is true? Low uncertainty (strong evidence) to High uncertainty (pure guess)
The Four Quadrants
                    HIGH UNCERTAINTY
                          |
    +-----------+---------+---------+-----------+
    |           |                   |           |
    |  Monitor  |   TEST FIRST     |           |
    |  (Low R,  |   (High R,       |           |
    |   High U) |    High U)       |           |
    |           |                   |           |
LOW RISK -------+---------+---------+------- HIGH RISK
    |           |                   |           |
    |  Ignore   |   Mitigate       |           |
    |  (Low R,  |   (High R,       |           |
    |   Low U)  |    Low U)        |           |
    |           |                   |           |
    +-----------+---------+---------+-----------+
                          |
                    LOW UNCERTAINTY
Quadrant Actions
Quadrant Risk Uncertainty Action
Test First High High Write hypothesis, design experiment, test immediately
Monitor Low High Gather data passively; test if uncertainty persists
Mitigate High Low Build safeguards; standard engineering/design best practices
Ignore Low Low Do not spend time here; proceed with confidence
Running the Prioritization Workshop

Time: 45-60 minutes Participants: Product manager, designer, tech lead, and one stakeholder

Steps:

  1. Generate assumptions (15 min). Each participant writes assumptions on sticky notes (physical or virtual). One assumption per note. Use prompts:

    • "Our users are..."
    • "Users will use this feature because..."
    • "This will work because..."
    • "We will make money by..."
    • "The biggest risk is..."
  2. De-duplicate and cluster (10 min). Group similar assumptions. Combine duplicates. Give each cluster a label.

  3. Plot on matrix (15 min). The facilitator reads each assumption aloud. The team discusses and places it on the 2x2 matrix. Disagreement is valuable; it reveals hidden uncertainty.

  4. Select top 3 for testing (10 min). From the "Test First" quadrant, choose the three assumptions that, if wrong, would most damage the project. These become the first hypotheses.

  5. Write hypotheses (10 min). Convert each selected assumption into a hypothesis using the standard format. Assign an owner and a target experiment date.

Business Assumptions vs. User Assumptions

Lean UX distinguishes two categories of assumptions. Both must be tested, but they require different experiments.

Business Assumptions

Business assumptions concern the viability and sustainability of the product from the organization's perspective.

Assumption Category Example Experiment Type
Revenue model "Users will pay $29/month for this feature" Pricing page test, pre-order, willingness-to-pay survey
Market size "There are 50,000 potential customers in our ICP" Market research, ad campaign response rates
Cost structure "We can deliver this for less than $5/user/month" Concierge MVP cost tracking
Channel "Users will discover us through organic search" SEO experiment, content test
Competitive advantage "Our solution is 3x faster than alternatives" Comparative usability test
User Assumptions

User assumptions concern the people who will use the product, their behaviors, needs, and context.

Assumption Category Example Experiment Type
Who they are "Our primary user is a mid-level marketing manager" Customer interviews, analytics demographics
What they need "Users need to generate reports weekly" Usage analytics, interview, diary study
Current behavior "Users currently use spreadsheets for this task" Contextual inquiry, survey
Motivation "Users will switch because our tool saves 2 hours/week" Time-on-task comparison, prototype test
Barriers "Users will not adopt if setup takes more than 10 minutes" Onboarding funnel analysis, usability test
Connecting the Two

A complete Lean UX canvas pairs business and user assumptions:

BUSINESS ASSUMPTION: Users will pay $29/month
  └─ USER ASSUMPTION: Users value the time saved enough to justify $29
       └─ HYPOTHESIS: We believe paid conversion will reach 5%
            if marketing managers who complete 3 reports
            with our auto-generated template feature
            save at least 2 hours per week.

Sub-Hypotheses

Large hypotheses often need decomposition. A sub-hypothesis isolates one variable from the parent hypothesis so it can be tested independently.

When to Use Sub-Hypotheses
  • The parent hypothesis involves multiple unknowns
  • Testing the parent hypothesis requires building too much
  • The team disagrees on which component is the riskiest
Decomposition Example

Parent hypothesis: "We believe monthly active users will increase by 30% if new users complete a personalized onboarding flow with an AI-powered recommendation engine."

Sub-hypotheses:

# Sub-Hypothesis Tests
1 "We believe new users will engage with a personalized onboarding flow (measured by 70% completion rate)" Clickable prototype test with 8 users
2 "We believe AI recommendations during onboarding will feel relevant (measured by >4/5 relevance rating)" Wizard of Oz test: manual recommendations presented as AI
3 "We believe users who complete personalized onboarding will return within 7 days at 2x the rate of standard onboarding" A/B test with coded prototype
Sub-Hypothesis Decision Tree

After testing sub-hypotheses:

  • All pass: Proceed to build the parent feature.
  • Some pass, some fail: Redesign the failing component; retest.
  • All fail: Pivot. The parent hypothesis is likely wrong.

Hypothesis Tracking Log

Maintain a living document (spreadsheet or wiki) to track all hypotheses across sprints.

ID Hypothesis Status Experiment Metric Target Actual Decision
H-001 Trial-to-paid +10% with setup wizard Testing Prototype test Completion rate 70% -- --
H-002 Cart abandonment -20% with one-click reorder Validated A/B test Abandonment rate 60% 58% Ship
H-003 Support time -30% with context panel Invalidated Usability test Task time 4 min 6 min Pivot
Review Cadence
  • Weekly: Update status of active experiments.
  • Sprint boundary: Review validated/invalidated count. Celebrate invalidations as learning.
  • Quarterly: Review patterns. Which assumption categories are most often wrong? Adjust future prioritization.

Hypothesis Canvas Template

Use this canvas at the start of every initiative:

LEAN UX HYPOTHESIS CANVAS
==========================

Project: _______________
Date: _______________
Team: _______________

ASSUMPTIONS (top 3 from prioritization)
1. _______________
2. _______________
3. _______________

HYPOTHESIS #1
We believe _______________
will happen if _______________
achieves _______________
with _______________.

Success metric: _______________
Target: _______________
Experiment type: _______________
Time box: _______________

HYPOTHESIS #2
We believe _______________
will happen if _______________
achieves _______________
with _______________.

Success metric: _______________
Target: _______________
Experiment type: _______________
Time box: _______________

SUB-HYPOTHESES (if needed)
1a. _______________
1b. _______________

OUTCOME (fill after experiment)
Result: _______________
Learning: _______________
Decision: [ ] Validate & ship  [ ] Iterate  [ ] Pivot  [ ] Kill
Next hypothesis: _______________

Anti-Patterns

Anti-Pattern Why It Fails Fix
Writing hypotheses after building Retroactive justification, not real testing Hypotheses must exist before any design work
Vague outcomes ("improve UX") Cannot be measured or falsified Use specific metrics with numeric targets
Testing the safe assumption first Wastes time; risky assumptions remain hidden Use the prioritization matrix; test high-risk, high-uncertainty first
One giant hypothesis per quarter Too many variables; impossible to learn from failure Decompose into sub-hypotheses testable in 1-2 weeks
No pre-set success criteria Team rationalizes any result as success Define pass/fail thresholds before the experiment begins
Hypothesis written by one person Lacks diverse perspectives; blind spots persist Run collaborative assumption workshop with full team
1# Hypothesis Canvas
2 
3The hypothesis canvas is the central planning artifact in Lean UX. It transforms vague product ideas into structured, testable predictions. Every design initiative should start here, not in a wireframing tool.
4 
5## The Lean UX Hypothesis Format
6 
7The standard hypothesis statement links four elements into a single testable prediction:
8 
9```
10We believe [outcome]
11will happen if [persona]
12achieves [action]
13with [feature].
14```
15 
16### Breaking Down the Components
17 
18| Component | Definition | Example |
19|-----------|-----------|---------|
20| **Outcome** | The measurable business or user result you expect | "A 15% increase in trial-to-paid conversion" |
21| **Persona** | The specific user segment the hypothesis targets | "First-time project managers using our free tier" |
22| **Action** | The behavior you expect users to perform | "Complete the guided project setup wizard within the first session" |
23| **Feature** | The design change or product element that enables the action | "A 3-step interactive setup wizard on the dashboard" |
24 
25### Complete Hypothesis Examples
26 
27**E-commerce checkout redesign:**
28"We believe cart abandonment will drop by 20% if returning shoppers can complete checkout in under 60 seconds with a one-click reorder button on the product page."
29 
30**SaaS onboarding:**
31"We believe 7-day retention will increase by 25% if new users who sign up via the marketing site achieve their first successful data import within 10 minutes with an auto-mapping CSV import tool."
32 
33**Internal tools:**
34"We believe support ticket resolution time will decrease by 30% if support agents can view the full customer timeline without switching tabs with a unified customer context panel in the ticket view."
35 
36**Mobile app engagement:**
37"We believe weekly active usage will increase by 40% if casual fitness users log at least 3 workouts in their first week with a simplified one-tap workout logging feature."
38 
39## Assumption Prioritization Matrix
40 
41Before writing hypotheses, the team must surface and prioritize assumptions. The prioritization matrix plots assumptions on two axes.
42 
43### The Two Axes
44 
45| Axis | Definition | Scale |
46|------|-----------|-------|
47| **Risk** | How damaging is it if this assumption is wrong? | Low risk (minor inconvenience) to High risk (project failure) |
48| **Uncertainty** | How confident are we that this assumption is true? | Low uncertainty (strong evidence) to High uncertainty (pure guess) |
49 
50### The Four Quadrants
51 
52```
53 HIGH UNCERTAINTY
54 |
55 +-----------+---------+---------+-----------+
56 | | | |
57 | Monitor | TEST FIRST | |
58 | (Low R, | (High R, | |
59 | High U) | High U) | |
60 | | | |
61LOW RISK -------+---------+---------+------- HIGH RISK
62 | | | |
63 | Ignore | Mitigate | |
64 | (Low R, | (High R, | |
65 | Low U) | Low U) | |
66 | | | |
67 +-----------+---------+---------+-----------+
68 |
69 LOW UNCERTAINTY
70```
71 
72### Quadrant Actions
73 
74| Quadrant | Risk | Uncertainty | Action |
75|----------|------|-------------|--------|
76| **Test First** | High | High | Write hypothesis, design experiment, test immediately |
77| **Monitor** | Low | High | Gather data passively; test if uncertainty persists |
78| **Mitigate** | High | Low | Build safeguards; standard engineering/design best practices |
79| **Ignore** | Low | Low | Do not spend time here; proceed with confidence |
80 
81### Running the Prioritization Workshop
82 
83**Time:** 45-60 minutes
84**Participants:** Product manager, designer, tech lead, and one stakeholder
85 
86**Steps:**
87 
881. **Generate assumptions (15 min).** Each participant writes assumptions on sticky notes (physical or virtual). One assumption per note. Use prompts:
89 - "Our users are..."
90 - "Users will use this feature because..."
91 - "This will work because..."
92 - "We will make money by..."
93 - "The biggest risk is..."
94 
952. **De-duplicate and cluster (10 min).** Group similar assumptions. Combine duplicates. Give each cluster a label.
96 
973. **Plot on matrix (15 min).** The facilitator reads each assumption aloud. The team discusses and places it on the 2x2 matrix. Disagreement is valuable; it reveals hidden uncertainty.
98 
994. **Select top 3 for testing (10 min).** From the "Test First" quadrant, choose the three assumptions that, if wrong, would most damage the project. These become the first hypotheses.
100 
1015. **Write hypotheses (10 min).** Convert each selected assumption into a hypothesis using the standard format. Assign an owner and a target experiment date.
102 
103## Business Assumptions vs. User Assumptions
104 
105Lean UX distinguishes two categories of assumptions. Both must be tested, but they require different experiments.
106 
107### Business Assumptions
108 
109Business assumptions concern the viability and sustainability of the product from the organization's perspective.
110 
111| Assumption Category | Example | Experiment Type |
112|---------------------|---------|-----------------|
113| **Revenue model** | "Users will pay $29/month for this feature" | Pricing page test, pre-order, willingness-to-pay survey |
114| **Market size** | "There are 50,000 potential customers in our ICP" | Market research, ad campaign response rates |
115| **Cost structure** | "We can deliver this for less than $5/user/month" | Concierge MVP cost tracking |
116| **Channel** | "Users will discover us through organic search" | SEO experiment, content test |
117| **Competitive advantage** | "Our solution is 3x faster than alternatives" | Comparative usability test |
118 
119### User Assumptions
120 
121User assumptions concern the people who will use the product, their behaviors, needs, and context.
122 
123| Assumption Category | Example | Experiment Type |
124|---------------------|---------|-----------------|
125| **Who they are** | "Our primary user is a mid-level marketing manager" | Customer interviews, analytics demographics |
126| **What they need** | "Users need to generate reports weekly" | Usage analytics, interview, diary study |
127| **Current behavior** | "Users currently use spreadsheets for this task" | Contextual inquiry, survey |
128| **Motivation** | "Users will switch because our tool saves 2 hours/week" | Time-on-task comparison, prototype test |
129| **Barriers** | "Users will not adopt if setup takes more than 10 minutes" | Onboarding funnel analysis, usability test |
130 
131### Connecting the Two
132 
133A complete Lean UX canvas pairs business and user assumptions:
134 
135```
136BUSINESS ASSUMPTION: Users will pay $29/month
137 └─ USER ASSUMPTION: Users value the time saved enough to justify $29
138 └─ HYPOTHESIS: We believe paid conversion will reach 5%
139 if marketing managers who complete 3 reports
140 with our auto-generated template feature
141 save at least 2 hours per week.
142```
143 
144## Sub-Hypotheses
145 
146Large hypotheses often need decomposition. A sub-hypothesis isolates one variable from the parent hypothesis so it can be tested independently.
147 
148### When to Use Sub-Hypotheses
149 
150- The parent hypothesis involves multiple unknowns
151- Testing the parent hypothesis requires building too much
152- The team disagrees on which component is the riskiest
153 
154### Decomposition Example
155 
156**Parent hypothesis:** "We believe monthly active users will increase by 30% if new users complete a personalized onboarding flow with an AI-powered recommendation engine."
157 
158**Sub-hypotheses:**
159 
160| # | Sub-Hypothesis | Tests |
161|---|---------------|-------|
162| 1 | "We believe new users will engage with a personalized onboarding flow (measured by 70% completion rate)" | Clickable prototype test with 8 users |
163| 2 | "We believe AI recommendations during onboarding will feel relevant (measured by >4/5 relevance rating)" | Wizard of Oz test: manual recommendations presented as AI |
164| 3 | "We believe users who complete personalized onboarding will return within 7 days at 2x the rate of standard onboarding" | A/B test with coded prototype |
165 
166### Sub-Hypothesis Decision Tree
167 
168After testing sub-hypotheses:
169 
170- **All pass:** Proceed to build the parent feature.
171- **Some pass, some fail:** Redesign the failing component; retest.
172- **All fail:** Pivot. The parent hypothesis is likely wrong.
173 
174## Hypothesis Tracking Log
175 
176Maintain a living document (spreadsheet or wiki) to track all hypotheses across sprints.
177 
178| ID | Hypothesis | Status | Experiment | Metric | Target | Actual | Decision |
179|----|-----------|--------|------------|--------|--------|--------|----------|
180| H-001 | Trial-to-paid +10% with setup wizard | Testing | Prototype test | Completion rate | 70% | -- | -- |
181| H-002 | Cart abandonment -20% with one-click reorder | Validated | A/B test | Abandonment rate | 60% | 58% | Ship |
182| H-003 | Support time -30% with context panel | Invalidated | Usability test | Task time | 4 min | 6 min | Pivot |
183 
184### Review Cadence
185 
186- **Weekly:** Update status of active experiments.
187- **Sprint boundary:** Review validated/invalidated count. Celebrate invalidations as learning.
188- **Quarterly:** Review patterns. Which assumption categories are most often wrong? Adjust future prioritization.
189 
190## Hypothesis Canvas Template
191 
192Use this canvas at the start of every initiative:
193 
194```
195LEAN UX HYPOTHESIS CANVAS
196==========================
197 
198Project: _______________
199Date: _______________
200Team: _______________
201 
202ASSUMPTIONS (top 3 from prioritization)
2031. _______________
2042. _______________
2053. _______________
206 
207HYPOTHESIS #1
208We believe _______________
209will happen if _______________
210achieves _______________
211with _______________.
212 
213Success metric: _______________
214Target: _______________
215Experiment type: _______________
216Time box: _______________
217 
218HYPOTHESIS #2
219We believe _______________
220will happen if _______________
221achieves _______________
222with _______________.
223 
224Success metric: _______________
225Target: _______________
226Experiment type: _______________
227Time box: _______________
228 
229SUB-HYPOTHESES (if needed)
2301a. _______________
2311b. _______________
232 
233OUTCOME (fill after experiment)
234Result: _______________
235Learning: _______________
236Decision: [ ] Validate & ship [ ] Iterate [ ] Pivot [ ] Kill
237Next hypothesis: _______________
238```
239 
240## Anti-Patterns
241 
242| Anti-Pattern | Why It Fails | Fix |
243|-------------|-------------|-----|
244| Writing hypotheses after building | Retroactive justification, not real testing | Hypotheses must exist before any design work |
245| Vague outcomes ("improve UX") | Cannot be measured or falsified | Use specific metrics with numeric targets |
246| Testing the safe assumption first | Wastes time; risky assumptions remain hidden | Use the prioritization matrix; test high-risk, high-uncertainty first |
247| One giant hypothesis per quarter | Too many variables; impossible to learn from failure | Decompose into sub-hypotheses testable in 1-2 weeks |
248| No pre-set success criteria | Team rationalizes any result as success | Define pass/fail thresholds before the experiment begins |
249| Hypothesis written by one person | Lacks diverse perspectives; blind spots persist | Run collaborative assumption workshop with full team |
250 

Discussion