skills/hypothesis-generation/references/causal_inference_and_claims.md
Association, prediction, intervention effects, and mechanisms answer different questions:
A model can predict accurately without identifying a causal effect. A randomized effect estimate can identify an intervention contrast without establishing the complete mechanism.
Following the causal-question and ICH E9(R1) principles where applicable, specify:
The estimand should exist before choosing an estimator or model.
Causal effects compare outcomes under different conditions for the same target units, although both conditions cannot usually be observed for one unit. Identification therefore depends on design and assumptions.
For observational data, state:
Do not write “controlled for confounding” as if adjustment proves exchangeability.
A common cause of exposure/intervention and outcome can create or obscure an association. Address through design, randomization where ethical/feasible, restriction, matching, measurement and adjustment of justified common causes, negative controls, sensitivity analysis, or triangulation.
Risks:
Selection into the sample, analysis, follow-up, or observed outcome can depend on causes of exposure and outcome. Record:
A collider is a common effect of two variables. Conditioning on it or its descendant can open a non-causal path. Common sources include:
More covariates are not automatically better.
The outcome or its precursors may influence the exposure or measurement. Cross-sectional order is especially weak evidence of direction. Use temporal design, lagged measurements, incident outcomes, intervention, negative controls, or explicit bidirectional candidates where appropriate.
Measurement error can:
Operationalization and validation are part of causal design, not a later documentation task.
Label the intended role before analysis and justify it with domain knowledge and a causal structure.
Lipsitch, Tchetgen Tchetgen, and Cohen distinguish negative-control exposures and outcomes:
Specify:
Negative controls detect some biases under assumptions; they do not prove absence of bias.
Use:
State design, population, timing, effect/summary measure, uncertainty, and limitations.
Use causal verbs only when:
For observational work, “estimated causal effect under the stated assumptions” is often more accurate than an unqualified causal declaration.
Distinguish:
A causal intervention effect does not by itself verify the proposed pathway.
The bundled linter recognizes line-level annotations:
[claim:associational] Exposure X was associated with outcome Y in the observed cohort.
[claim:causal][estimand:E1][identification:observational_assumption_dependent][confounding:unresolved][selection:assessed][collider:assessed][reverse-causation:assessed] Under the stated assumptions, intervention X would reduce outcome Y over 12 months.
Allowed risk states are assessed, unresolved, and not_applicable. “Assessed” records that a human evaluation exists; it does not mean the risk is absent.
Run:
python3 scripts/lint_causal_claims.py local-draft.md
The linter is lexical. It can miss causal language, flag benign phrases, and cannot judge whether a design identifies an effect.
For intervention hypotheses:
Reporting completeness is not proof of ethical approval, design validity, regulatory compliance, or treatment efficacy.