Skill Tracer
Skills › Scientific Agent Skills › hypothesis-generation › concepts_and_workflow.md

concepts_and_workflow.md

173 lines · skills/hypothesis-generation/references/concepts_and_workflow.md at 5f2bc03

Open on GitHub
1# Concepts and Candidate Lifecycle
2

Concepts and Candidate Lifecycle

Raw lines 1 to 2
3## Purpose
4
5This reference prevents common category errors in hypothesis work. It is a vocabulary and workflow guide, not a theory of confirmation and not an automatic ranking method.
6

Purpose

This reference prevents common category errors in hypothesis work. It is a vocabulary and workflow guide, not a theory of confirmation and not an automatic ranking method.

Raw lines 3 to 6
7## Object model
8

Object model

Raw lines 7 to 8
9### Observation
11A bounded account of what was detected or reported:
13- source or measurement;
14- population/system, place, and time;
15- unit of observation;
16- preprocessing, exclusions, missingness, and uncertainty;
17- whether the observation was expected or selected after inspection.
19An observation can be mistaken, biased, or unrepresentative. It does not explain itself.

Observation

A bounded account of what was detected or reported:

  • source or measurement;
  • population/system, place, and time;
  • unit of observation;
  • preprocessing, exclusions, missingness, and uncertainty;
  • whether the observation was expected or selected after inspection.

An observation can be mistaken, biased, or unrepresentative. It does not explain itself.

Raw lines 9 to 20
21### Research question
23An answerable question that fixes the scope of inquiry. It should identify the target population/system, variables or interventions, comparator where meaningful, outcome, timeframe, context, and claim type.
25PICO/PICOT is appropriate for many intervention-effect questions. It is not a universal ontology. Use a framework matched to the question and involve affected stakeholders where appropriate.

Research question

An answerable question that fixes the scope of inquiry. It should identify the target population/system, variables or interventions, comparator where meaningful, outcome, timeframe, context, and claim type.

PICO/PICOT is appropriate for many intervention-effect questions. It is not a universal ontology. Use a framework matched to the question and involve affected stakeholders where appropriate.

Raw lines 21 to 26
27### Hypothesis
29A candidate proposition that could explain or relate observations and yield testable implications. Keep its status as `candidate` until evidence changes the state. Avoid “validated hypothesis,” “proven mechanism,” and similar language unless the statement is being used only to quote a source accurately.

Hypothesis

A candidate proposition that could explain or relate observations and yield testable implications. Keep its status as candidate until evidence changes the state. Avoid “validated hypothesis,” “proven mechanism,” and similar language unless the statement is being used only to quote a source accurately.

Raw lines 27 to 30
31### Mechanism
33A proposed process connecting antecedent conditions to an outcome. A mechanism should identify entities, activities, ordering, and boundary conditions where the domain permits. A plausible narrative without discriminating predictions remains a story.

Mechanism

A proposed process connecting antecedent conditions to an outcome. A mechanism should identify entities, activities, ordering, and boundary conditions where the domain permits. A plausible narrative without discriminating predictions remains a story.

Raw lines 31 to 34
35### Causal estimand
37A precise target causal contrast. At minimum, state:
39- target population/system;
40- intervention/exposure and comparator;
41- outcome and time horizon;
42- population-level summary;
43- treatment versions and intercurrent-event strategy where relevant;
44- identification assumptions.
46The estimand is the target, the estimator is the method, and the estimate is the numerical result.

Causal estimand

A precise target causal contrast. At minimum, state:

  • target population/system;
  • intervention/exposure and comparator;
  • outcome and time horizon;
  • population-level summary;
  • treatment versions and intercurrent-event strategy where relevant;
  • identification assumptions.

The estimand is the target, the estimator is the method, and the estimate is the numerical result.

Raw lines 35 to 47
48### Prediction
50An observable implication derived from a candidate before checking the target result. A useful prediction specifies conditions, measurement, expected pattern, uncertainty, and an incompatible result. It should distinguish at least one rival when possible.

Prediction

An observable implication derived from a candidate before checking the target result. A useful prediction specifies conditions, measurement, expected pattern, uncertainty, and an incompatible result. It should distinguish at least one rival when possible.

Raw lines 48 to 51
52### Alternative explanation
54A rival account that could produce the same observation. Rivals include:
56- distinct mechanisms;
57- measurement or processing artifacts;
58- confounding/common causes;
59- selection or attrition;
60- collider conditioning;
61- reverse causation;
62- contextual or temporal heterogeneity;
63- stochastic variation.
65Rivals can coexist. Do not force mutual exclusivity when a mixed explanation is scientifically plausible.

Alternative explanation

A rival account that could produce the same observation. Rivals include:

  • distinct mechanisms;
  • measurement or processing artifacts;
  • confounding/common causes;
  • selection or attrition;
  • collider conditioning;
  • reverse causation;
  • contextual or temporal heterogeneity;
  • stochastic variation.

Rivals can coexist. Do not force mutual exclusivity when a mixed explanation is scientifically plausible.

Raw lines 52 to 66
67### Null hypothesis
69A defined no-effect/no-difference model used in an analysis. It is not “nothing happened,” and failure to reject it does not establish equivalence or absence. Define compatibility, equivalence, or non-inferiority rules separately when those are the scientific targets.

Null hypothesis

A defined no-effect/no-difference model used in an analysis. It is not “nothing happened,” and failure to reject it does not establish equivalence or absence. Define compatibility, equivalence, or non-inferiority rules separately when those are the scientific targets.

Raw lines 67 to 70
71### Negative control
73A control in which the target mechanism should not operate but relevant bias pathways should remain. Negative exposure and negative outcome controls can reveal confounding, selection, measurement, or analytic bias when their assumptions are credible. A negative control does not repair bias automatically.

Negative control

A control in which the target mechanism should not operate but relevant bias pathways should remain. Negative exposure and negative outcome controls can reveal confounding, selection, measurement, or analytic bias when their assumptions are credible. A negative control does not repair bias automatically.

Raw lines 71 to 74
75### Operationalization
77The mapping from a construct to a measurement, category, intervention, or variable. Record instrument/method, unit, timing, population/system, validity, reliability, calibration, missingness, transformations, cut points, and limitations.

Operationalization

The mapping from a construct to a measurement, category, intervention, or variable. Record instrument/method, unit, timing, population/system, validity, reliability, calibration, missingness, transformations, cut points, and limitations.

Raw lines 75 to 78
79### Analysis plan
81The planned mapping from data to estimand, prediction, or descriptive target. It includes units, populations, transformations, models, contrasts, effect measures, uncertainty, missingness, multiplicity, diagnostics, sensitivity analyses, and decision rules.

Analysis plan

The planned mapping from data to estimand, prediction, or descriptive target. It includes units, populations, transformations, models, contrasts, effect measures, uncertainty, missingness, multiplicity, diagnostics, sensitivity analyses, and decision rules.

Raw lines 79 to 82
83### Evidence
85Empirical observations or documented sources that bear on claims. Record whether a source supports, challenges, contextualizes, or supplies a method. Citation presence does not prove claim support; a human must inspect the source.

Evidence

Empirical observations or documented sources that bear on claims. Record whether a source supports, challenges, contextualizes, or supplies a method. Citation presence does not prove claim support; a human must inspect the source.

Raw lines 83 to 86
87## Candidate lifecycle
89Use explicit states:
911. **Draft candidate** — generated but not yet searched or operationalized.
922. **Evidence-bounded candidate** — linked to a dated search and source ledger.
933. **Test-ready candidate** — has measurements, rivals, falsifiers, controls, and analysis links.
944. **Preregistered candidate** — time-stamped before the relevant outcome was inspected.
955. **Tested candidate** — results and deviations are available.
966. **Retained, revised, challenged, or unresolved** — human interpretation with uncertainty.
98Never use `true`, `proven`, or `selected_winner` as a machine-generated state.

Candidate lifecycle

Use explicit states:

  1. Draft candidate — generated but not yet searched or operationalized.
  2. Evidence-bounded candidate — linked to a dated search and source ledger.
  3. Test-ready candidate — has measurements, rivals, falsifiers, controls, and analysis links.
  4. Preregistered candidate — time-stamped before the relevant outcome was inspected.
  5. Tested candidate — results and deviations are available.
  6. Retained, revised, challenged, or unresolved — human interpretation with uncertainty.

Never use true, proven, or selected_winner as a machine-generated state.

Raw lines 87 to 99
100## Multiple hypotheses and strong inference
102Platt’s 1964 strong-inference essay advocates:
1041. devising alternative hypotheses;
1052. devising a crucial experiment with alternative possible outcomes that exclude candidates;
1063. performing the experiment cleanly;
1074. recycling the process with subhypotheses.
109Use this as a discipline for contrast, not as a guarantee of truth. In practice:
111- alternatives may be incomplete;
112- candidates may not be mutually exclusive;
113- auxiliary assumptions can fail;
114- measurements may not distinguish the intended mechanisms;
115- a “crucial” result may be indeterminate;
116- exclusions remain provisional.
118Always include an “unknown or mixed explanation” path in interpretation.

Multiple hypotheses and strong inference

Platt’s 1964 strong-inference essay advocates:

  1. devising alternative hypotheses;
  2. devising a crucial experiment with alternative possible outcomes that exclude candidates;
  3. performing the experiment cleanly;
  4. recycling the process with subhypotheses.

Use this as a discipline for contrast, not as a guarantee of truth. In practice:

  • alternatives may be incomplete;
  • candidates may not be mutually exclusive;
  • auxiliary assumptions can fail;
  • measurements may not distinguish the intended mechanisms;
  • a “crucial” result may be indeterminate;
  • exclusions remain provisional.

Always include an “unknown or mixed explanation” path in interpretation.

Raw lines 100 to 119
120## Exploratory and confirmatory modes

Exploratory and confirmatory modes

Raw lines 120 to 121
122### Exploratory
124- Generates observations, candidates, variables, and models.
125- Can be data-dependent.
126- Must record that dependence.
127- Produces hypotheses for future tests rather than relabeling the same-data analysis as confirmation.

Exploratory

  • Generates observations, candidates, variables, and models.
  • Can be data-dependent.
  • Must record that dependence.
  • Produces hypotheses for future tests rather than relabeling the same-data analysis as confirmation.
Raw lines 122 to 128
129### Confirmatory
131- Defines hypotheses, outcomes, exclusions, transformations, models, and decision rules before inspecting the target result.
132- Preserves the planned analysis.
133- Reports deviations and additional analyses transparently.
135Both modes are scientifically valuable. The integrity failure is not exploration; it is presenting exploration as if it were prespecified.

Confirmatory

  • Defines hypotheses, outcomes, exclusions, transformations, models, and decision rules before inspecting the target result.
  • Preserves the planned analysis.
  • Reports deviations and additional analyses transparently.

Both modes are scientifically valuable. The integrity failure is not exploration; it is presenting exploration as if it were prespecified.

Raw lines 129 to 136
137## Uncertainty vocabulary
139Prefer:
141- “candidate explanation”;
142- “consistent with under the stated assumptions”;
143- “challenges this candidate if measurement and design assumptions hold”;
144- “not distinguished by this result”;
145- “not located within the documented search boundary”;
146- “requires replication or external validation.”
148Avoid:
150- “proved” or “disproved” for ordinary empirical results;
151- “novel” based only on no quick search hit;
152- “no effect” from a non-significant result;
153- “causes” from an unqualified association;
154- “the mechanism” when several remain plausible.

Uncertainty vocabulary

Prefer:

  • “candidate explanation”;
  • “consistent with under the stated assumptions”;
  • “challenges this candidate if measurement and design assumptions hold”;
  • “not distinguished by this result”;
  • “not located within the documented search boundary”;
  • “requires replication or external validation.”

Avoid:

  • “proved” or “disproved” for ordinary empirical results;
  • “novel” based only on no quick search hit;
  • “no effect” from a non-significant result;
  • “causes” from an unqualified association;
  • “the mechanism” when several remain plausible.
Raw lines 137 to 155
156## Minimum handoff
158A hypothesis package should contain:
160- frozen observation;
161- framed question and claim type;
162- dated search boundary and source ledger;
163- candidate hypotheses and mechanisms;
164- rivals and bias explanations;
165- causal estimand if applicable;
166- discriminating predictions and falsifiers;
167- operationalization and measurement-validity record;
168- nulls and controls;
169- design and analysis plan;
170- uncertainty and boundary conditions;
171- ethics/safety/regulatory gates;
172- preregistration/deviation plan;
173- accountable human review.

Minimum handoff

A hypothesis package should contain:

  • frozen observation;
  • framed question and claim type;
  • dated search boundary and source ledger;
  • candidate hypotheses and mechanisms;
  • rivals and bias explanations;
  • causal estimand if applicable;
  • discriminating predictions and falsifiers;
  • operationalization and measurement-validity record;
  • nulls and controls;
  • design and analysis plan;
  • uncertainty and boundary conditions;
  • ethics/safety/regulatory gates;
  • preregistration/deviation plan;
  • accountable human review.
Raw lines 156 to 173