Hypothesis Discipline
Core Principle
A hypothesis is not a guess — it is a structured statement with clear validation criteria and a time budget. Every hypothesis must answer: "How will we know if this is true or false?"
Hypothesis Characteristics
- Hypotheses exist at every level of the OST hierarchy (Outcome → Opportunity → Solution → Assumption)
- Each hypothesis has a target level attribute indicating which OST level it addresses
- Hypotheses follow an ADR-style lifecycle — a single file tracks the full journey from draft to conclusion
- Rejected and invalidated hypotheses remain in their lifecycle file as learning assets
Hypothesis Lifecycle
draft → testing → validated → adopted
→ rejected (validated but not adopted)
→ invalidated (disproven by evidence)
→ inconclusive (evidence gathered but insufficient to confirm or deny)
→ timeout (deadline passed, decision needed: continue or stop)
Hypothesis File Schema
The authoritative schema is defined in references/hypothesis-template.md. Key fields:
id: HYPO-NNN
level: outcome / opportunity / solution / assumption
status: draft / testing / validated / invalidated / inconclusive / adopted / rejected / timeout
confidence: per-risk scores (value, usability, feasibility, viability) on 0-10 scale
time-budget and deadline: validation time constraints
Validation Criteria Requirements
Every hypothesis must define before testing begins:
- We believe that — the hypothesis statement
- We'll know we're right when — measurable success criteria
- We'll know we're wrong when — measurable failure criteria
- Validation method — how we will test (prototype, data analysis, interview, code spike, market research)
- Time budget — maximum time investment before forced decision
Time Budget and Cutoff
- Every hypothesis gets a time budget (e.g., 1d, 1w, 2w)
- A deadline sets the hard cutoff date
- When deadline passes without conclusion → status becomes
timeout
- Timeout forces a decision: extend (with justification), pivot, or abandon
- Bound every validation with a time budget and deadline so exploration ends in an explicit decision
Confidence Update Rules
- Confidence scores are updated only when new evidence is gathered
- Record the evidence that justified each score change
- Confidence can go down as well as up — negative evidence is valid evidence
- Different risk dimensions can have different confidence levels
Result Recording
When a hypothesis reaches conclusion (validated/invalidated/inconclusive/adopted/rejected):
- Record the result in the hypothesis file with evidence
- Update confidence scores with final values
- Link to evidence (data, screenshots, prototype results, interview notes)
- Record decision learning — conclusions and evidence that can change confidence, the Opportunity, or a downstream decision
- Update the parent Opportunity if the result changes its understanding
Key Disciplines
- Separate creation from evaluation: Generate candidate hypotheses before evaluating them
- Seek disconfirming evidence: Actively look for reasons the hypothesis might be wrong
- One hypothesis, one test: Each validation produces an interpretable result for one hypothesis
- Record decision evidence: Preserve conclusions, evidence, and reasoning that can change confidence, the parent Opportunity, a downstream decision, or future validation. Omit working narration and baseline knowledge with no consumer
- Rejected ≠ worthless: A rejected hypothesis teaches what doesn't work and why
- Inconclusive is honest: When evidence is insufficient, say so instead of forcing a verdict
1---2name: hypothesis-discipline-23description: Manages hypothesis lifecycle, enforces validation criteria, time budgets, and confidence scoring rules. Use when creating hypotheses, updating confidence scores, setting validation criteria, handling timeouts, or recording validation results.4---56# Hypothesis Discipline78## Core Principle910A hypothesis is not a guess — it is a **structured statement with clear validation criteria and a time budget**. Every hypothesis must answer: "How will we know if this is true or false?"1112## Hypothesis Characteristics1314- Hypotheses exist at **every level** of the OST hierarchy (Outcome → Opportunity → Solution → Assumption)15- Each hypothesis has a **target level** attribute indicating which OST level it addresses16- Hypotheses follow an **ADR-style lifecycle** — a single file tracks the full journey from draft to conclusion17- **Rejected and invalidated hypotheses remain in their lifecycle file** as learning assets1819## Hypothesis Lifecycle2021```22draft → testing → validated → adopted23 → rejected (validated but not adopted)24 → invalidated (disproven by evidence)25 → inconclusive (evidence gathered but insufficient to confirm or deny)26 → timeout (deadline passed, decision needed: continue or stop)27```2829## Hypothesis File Schema3031The authoritative schema is defined in `references/hypothesis-template.md`. Key fields:3233- `id`: HYPO-NNN34- `level`: outcome / opportunity / solution / assumption35- `status`: draft / testing / validated / invalidated / inconclusive / adopted / rejected / timeout36- `confidence`: per-risk scores (value, usability, feasibility, viability) on 0-10 scale37- `time-budget` and `deadline`: validation time constraints3839## Validation Criteria Requirements4041Every hypothesis **must** define before testing begins:42431. **We believe that** — the hypothesis statement442. **We'll know we're right when** — measurable success criteria453. **We'll know we're wrong when** — measurable failure criteria464. **Validation method** — how we will test (prototype, data analysis, interview, code spike, market research)475. **Time budget** — maximum time investment before forced decision4849## Time Budget and Cutoff5051- Every hypothesis gets a **time budget** (e.g., 1d, 1w, 2w)52- A **deadline** sets the hard cutoff date53- When deadline passes without conclusion → status becomes `timeout`54- Timeout forces a decision: extend (with justification), pivot, or abandon55- **Bound every validation** with a time budget and deadline so exploration ends in an explicit decision5657## Confidence Update Rules5859- Confidence scores are updated **only when new evidence is gathered**60- Record the evidence that justified each score change61- Confidence can go **down** as well as up — negative evidence is valid evidence62- Different risk dimensions can have different confidence levels6364## Result Recording6566When a hypothesis reaches conclusion (validated/invalidated/inconclusive/adopted/rejected):67681. **Record the result** in the hypothesis file with evidence692. **Update confidence scores** with final values703. **Link to evidence** (data, screenshots, prototype results, interview notes)714. **Record decision learning** — conclusions and evidence that can change confidence, the Opportunity, or a downstream decision725. **Update the parent Opportunity** if the result changes its understanding7374## Key Disciplines7576- **Separate creation from evaluation**: Generate candidate hypotheses before evaluating them77- **Seek disconfirming evidence**: Actively look for reasons the hypothesis might be wrong78- **One hypothesis, one test**: Each validation produces an interpretable result for one hypothesis79- **Record decision evidence**: Preserve conclusions, evidence, and reasoning that can change confidence, the parent Opportunity, a downstream decision, or future validation. Omit working narration and baseline knowledge with no consumer80- **Rejected ≠ worthless**: A rejected hypothesis teaches what doesn't work and why81- **Inconclusive is honest**: When evidence is insufficient, say so instead of forcing a verdict