/construct-causal-model

name: construct-causal-model
description: "Construct and validate an explicit causal model with measurable variables, mechanism edges, evidence links, feedback loops, interventions, counterevidence, and confidence."

construct-causal-model

Purpose

Construct and validate an explicit causal model with measurable variables, mechanism edges, evidence links, feedback loops, interventions, counterevidence, and confidence.

Input contract

required: [variable_records, mechanism_candidates, evidence_records]
optional: [assumptions, prior_findings, evidence_updates]
constraints: [consume named scientific objects; preserve provenance; keep unresolved uncertainty visible]

Execution protocol

Do not perform called SOP operations inline; each loaded SOP owns its contract and thresholds.

1. You MUST load skill `identify-variables` to inventory outcomes, factors, mediators, moderators, confounders, and assumptions before drawing any edge. 2. You MUST load skill `extract-causal-structure` to extract directed cause-mediator-effect chains with temporal order, boundary conditions, and evidence anchors. 3. You MUST load skill `represent-mechanism-edge` to encode each mechanism edge with pathway, sign, enabling conditions, falsifier, and strength. 4. You MUST load skill `attach-evidence-to-relation` to attach independent supporting and contradicting evidence while retaining alternative interpretations. 5. You MUST load skill `detect-contradiction` to compare opposing causal claims under common scope before validation. 6. You MUST load skill `detect-feedback-loop` to find reinforcing and balancing cycles, delays, uncertain edges, and testable loop implications. 7. You MUST load skill `trace-causal-chain` to trace target outcomes through intermediate nodes, branches, and because-links. 8. You MUST load skill `analyze-intervention` to map intervention components, dose, timing, implementation fidelity, comparators, and heterogeneous effects. 9. You MUST load skill `construct-counterfactual` to propagate a declared intervention and classify the counterfactual outcome. 10. You MUST load skill `validate-causal-link` to apply CLR-style checks for existence, connection, sufficiency, omitted conditions, and alternatives. 11. You MUST load skill `update-confidence-from-evidence` to reweight confidence while preserving unresolved conflicts and permitted bounds. If the model should generate testable explanations, consider `formulate-hypotheses`. If a specific intervention needs minimal-flip and necessity analysis, consider `counterfactual-causal-analysis`.

Deviation: reorder only when a dependency is already satisfied or unavailable; record the reason and confidence effect.

Output contract

produces: [causal_graph, mechanism_edges, intervention_implications, confidence_updates]
delta_fields: [findings, decisions]

Thresholds and quality gates

• Each output is traceable to an input object, operation, and evidence reference.
• Scope, assumptions, and unresolved alternatives remain explicit.
• Retain $\alpha$ 0.05 and power 0.8 wherever the predeclared statistical design requires them.

Failure and counterexamples

Stop synthesis when a required object is absent, a precondition is violated, or a counterexample invalidates the proposed conclusion; return the partial delta with the failure recorded.

Provenance map

• intermediate: knowledge-structuring/causal-modeling [campaign]
• intermediate: variable-identification [strategy]
• resolved: mechanism-mapping
• resolved: evidence-collection
• resolved: intervention-analysis
• resolved: model-validation
• resolved: counterfactual-reasoning
• resolved: evidence-weighing

Preserved source criteria ledger

| source | criterion | treatment | |---|---|---| | resolved v3 entries above | node-specific criteria | retained and specialized to the v4 object contract | | experiment-execution/statistical-testing | $\alpha$ = 0.05 | fixed value retained where applicable | | experiment-execution/sample-size-estimation | power = 0.8 | fixed value retained where applicable |

Context checkpoint / Delta notes

Return the node-specific research-state delta and preserve findings, evidence updates, uncertainties, decisions, open questions, and recommended jumps as applicable.