Iteration Decision Support
Analyze the state of a completed hypothesis experiment and the overall
hypothesis graph to recommend the next action.
Context
After each experiment, the researcher makes one of four decisions:
- Continue — hypothesis confirmed, deepen this direction, formulate
child hypotheses.
- Pivot — result points to a more promising direction different from
the current one. Formulate new hypotheses, change vector.
- Kill — branch is a dead end (refuted, unstable, impractical). Prune
the branch in the graph, document the reason.
- Fork — competing approaches discovered that are worth investigating
in parallel. Create multiple child hypotheses for simultaneous exploration.
The decision is the researcher's, but this skill provides structured analysis
and a recommendation to support it.
Procedure
Step 1 — Read current state
Gather the following information:
- The completed hypothesis card — read
hypotheses/H-NNN.md for the
statement, verification criterion, result, and status.
- The hypothesis graph — read
hypotheses/graph.md to understand the
full DAG: which branches are alive, which are pruned, where pivots
occurred, and what the current "front line" looks like.
- The research brief — read
brief.md for the research question,
success criteria, scope boundaries, known constraints, and time budget.
- Sibling/related hypotheses — if the completed hypothesis is part of
a fork, read its sibling hypotheses to compare results.
Step 2 — Analyze the result
Evaluate the experiment outcome against multiple dimensions:
2a. Verification criterion alignment
- Was the verification criterion met, partially met, or not met?
- Is the result definitive or are there caveats?
- If inconclusive: is the inconclusiveness due to the approach, the
timebox, or an external factor?
2b. Research question proximity
- How much closer does this result bring us to answering the research
question from the brief?
- Does the result open new pathways toward the answer?
- Does the result suggest the research question itself needs refinement?
2c. Resource and timebox assessment
- How much of the overall research time budget has been consumed?
- How many active branches remain in the graph?
- Is there sufficient budget to pursue new directions, or should the
research begin converging?
2d. Surprise and serendipity
- Did the experiment reveal unexpected findings outside the original scope?
- Are there serendipitous discoveries worth pursuing (potential fork)?
Step 3 — Generate recommendation
Based on the analysis, recommend one of the four decisions with
justification:
Continue — recommend when:
- The hypothesis was confirmed.
- The result directly advances the research question.
- There are clear, specific follow-up questions.
- Budget allows further depth.
When recommending Continue, propose 1–3 specific child hypotheses with
draft statements and verification criteria.
Pivot — recommend when:
- The result (positive or negative) reveals a more promising direction.
- The current branch has diminishing returns.
- A related but different approach looks more viable.
When recommending Pivot, clearly articulate:
- What the new direction is and why it is more promising.
- What is being left behind and why.
- Proposed hypothesis(es) for the new direction.
Kill — recommend when:
- The hypothesis was definitively refuted.
- The timebox expired without meaningful progress.
- The branch is technically viable but impractical (too complex, too slow,
too fragile for the intended use case).
- Continuing this branch will not help answer the research question.
When recommending Kill, document:
- The specific reason for termination.
- Any useful knowledge gained that should be preserved.
- Whether this dead end has implications for other branches.
Fork — recommend when:
- Two or more competing approaches are identified.
- It is unclear which approach is superior without trying both.
- Resources are available for parallel investigation.
When recommending Fork, propose:
- The competing hypotheses (2–3 maximum).
- Individual timeboxes for each.
- Selection criteria: how will we choose the winner (or discard both)?
Step 4 — Present to the researcher
Present the analysis and recommendation in a structured format:
- Result summary: one paragraph on what the experiment showed.
- Graph context: where this result fits in the overall research.
- Recommendation: the decision (Continue / Pivot / Kill / Fork) with
reasoning.
- Proposed next hypotheses: if applicable, draft cards for the next
hypotheses.
- Risks and alternatives: what could go wrong with the recommendation,
and what the alternative decision would be.
Step 5 — Execute the decision
Once the researcher confirms (or modifies) the decision:
- Update the completed hypothesis card with the decision in the
"Decision" field.
- If the decision is Continue or Fork: invoke
research-hypothesis
to create the new child hypothesis cards.
- If the decision is Pivot: invoke
research-hypothesis to create new
hypotheses. Mark the abandoned branch hypotheses as cancelled if they
are still open.
- If the decision is Kill: ensure the hypothesis status is
refuted
or cancelled as appropriate. No new hypotheses are created on this
branch.
Decision Heuristics
Some rules of thumb encoded in the methodology:
- Timebox expiry + inconclusive = kill or pivot, not extension. The
methodology explicitly discourages extending timeboxes.
- Budget pressure → convergence: when more than ~70% of the overall
research budget is consumed, prefer Continue (deepening) over Fork
(broadening). Begin thinking about synthesis.
- Fork is the exception: parallel investigation is allowed but should
be justified. The default is sequential hypothesis testing.
- Preserve knowledge from dead ends: killed branches still produced
knowledge. Ensure the "what we learned" section of the card is thorough.
Relation to Other Skills
- Invoked after
research-experiment records a result.
- Creates new hypotheses via
research-hypothesis.
- Feeds into
research-synthesis when the research question is answered
or budget is exhausted (triggers Phase 3).
research-status provides the graph overview that informs decisions.
1---2name: research-decision3description: Analyze hypothesis results and the current state of the hypothesis graph to recommend continue, pivot, kill, or fork decisions for an research iteration. Considers timebox constraints, budget, research question alignment, and graph topology. Use after an experiment completes, when the researcher needs help deciding next steps, or when reviewing the overall research direction.4---56# Iteration Decision Support78Analyze the state of a completed hypothesis experiment and the overall9hypothesis graph to recommend the next action.1011## Context1213After each experiment, the researcher makes one of four decisions:1415- **Continue** — hypothesis confirmed, deepen this direction, formulate16 child hypotheses.17- **Pivot** — result points to a more promising direction different from18 the current one. Formulate new hypotheses, change vector.19- **Kill** — branch is a dead end (refuted, unstable, impractical). Prune20 the branch in the graph, document the reason.21- **Fork** — competing approaches discovered that are worth investigating22 in parallel. Create multiple child hypotheses for simultaneous exploration.2324The decision is the researcher's, but this skill provides structured analysis25and a recommendation to support it.2627## Procedure2829### Step 1 — Read current state3031Gather the following information:32331. **The completed hypothesis card** — read `hypotheses/H-NNN.md` for the34 statement, verification criterion, result, and status.352. **The hypothesis graph** — read `hypotheses/graph.md` to understand the36 full DAG: which branches are alive, which are pruned, where pivots37 occurred, and what the current "front line" looks like.383. **The research brief** — read `brief.md` for the research question,39 success criteria, scope boundaries, known constraints, and time budget.404. **Sibling/related hypotheses** — if the completed hypothesis is part of41 a fork, read its sibling hypotheses to compare results.4243### Step 2 — Analyze the result4445Evaluate the experiment outcome against multiple dimensions:4647#### 2a. Verification criterion alignment4849- Was the verification criterion met, partially met, or not met?50- Is the result definitive or are there caveats?51- If inconclusive: is the inconclusiveness due to the approach, the52 timebox, or an external factor?5354#### 2b. Research question proximity5556- How much closer does this result bring us to answering the research57 question from the brief?58- Does the result open new pathways toward the answer?59- Does the result suggest the research question itself needs refinement?6061#### 2c. Resource and timebox assessment6263- How much of the overall research time budget has been consumed?64- How many active branches remain in the graph?65- Is there sufficient budget to pursue new directions, or should the66 research begin converging?6768#### 2d. Surprise and serendipity6970- Did the experiment reveal unexpected findings outside the original scope?71- Are there serendipitous discoveries worth pursuing (potential fork)?7273### Step 3 — Generate recommendation7475Based on the analysis, recommend one of the four decisions with76justification:7778#### Continue — recommend when:79- The hypothesis was confirmed.80- The result directly advances the research question.81- There are clear, specific follow-up questions.82- Budget allows further depth.8384When recommending Continue, propose 1–3 specific child hypotheses with85draft statements and verification criteria.8687#### Pivot — recommend when:88- The result (positive or negative) reveals a more promising direction.89- The current branch has diminishing returns.90- A related but different approach looks more viable.9192When recommending Pivot, clearly articulate:93- What the new direction is and why it is more promising.94- What is being left behind and why.95- Proposed hypothesis(es) for the new direction.9697#### Kill — recommend when:98- The hypothesis was definitively refuted.99- The timebox expired without meaningful progress.100- The branch is technically viable but impractical (too complex, too slow,101 too fragile for the intended use case).102- Continuing this branch will not help answer the research question.103104When recommending Kill, document:105- The specific reason for termination.106- Any useful knowledge gained that should be preserved.107- Whether this dead end has implications for other branches.108109#### Fork — recommend when:110- Two or more competing approaches are identified.111- It is unclear which approach is superior without trying both.112- Resources are available for parallel investigation.113114When recommending Fork, propose:115- The competing hypotheses (2–3 maximum).116- Individual timeboxes for each.117- Selection criteria: how will we choose the winner (or discard both)?118119### Step 4 — Present to the researcher120121Present the analysis and recommendation in a structured format:1221231. **Result summary**: one paragraph on what the experiment showed.1242. **Graph context**: where this result fits in the overall research.1253. **Recommendation**: the decision (Continue / Pivot / Kill / Fork) with126 reasoning.1274. **Proposed next hypotheses**: if applicable, draft cards for the next128 hypotheses.1295. **Risks and alternatives**: what could go wrong with the recommendation,130 and what the alternative decision would be.131132### Step 5 — Execute the decision133134Once the researcher confirms (or modifies) the decision:1351361. Update the completed hypothesis card with the decision in the137 "Decision" field.1382. If the decision is **Continue** or **Fork**: invoke `research-hypothesis`139 to create the new child hypothesis cards.1403. If the decision is **Pivot**: invoke `research-hypothesis` to create new141 hypotheses. Mark the abandoned branch hypotheses as `cancelled` if they142 are still open.1434. If the decision is **Kill**: ensure the hypothesis status is `refuted`144 or `cancelled` as appropriate. No new hypotheses are created on this145 branch.146147## Decision Heuristics148149Some rules of thumb encoded in the methodology:150151- **Timebox expiry + inconclusive = kill or pivot**, not extension. The152 methodology explicitly discourages extending timeboxes.153- **Budget pressure → convergence**: when more than ~70% of the overall154 research budget is consumed, prefer Continue (deepening) over Fork155 (broadening). Begin thinking about synthesis.156- **Fork is the exception**: parallel investigation is allowed but should157 be justified. The default is sequential hypothesis testing.158- **Preserve knowledge from dead ends**: killed branches still produced159 knowledge. Ensure the "what we learned" section of the card is thorough.160161## Relation to Other Skills162163- Invoked after `research-experiment` records a result.164- Creates new hypotheses via `research-hypothesis`.165- Feeds into `research-synthesis` when the research question is answered166 or budget is exhausted (triggers Phase 3).167- `research-status` provides the graph overview that informs decisions.