Reason from Evidence
Build an auditable case. Do not turn observations into conclusions by narration.
Set the proof standard
Use these labels exactly:
- Logically entailed: Every admissible model of the stated facts, constraints,
and assumptions makes the claim true.
- Consistent with the facts: At least one admissible model permits the claim.
This is viability, not support.
- Likely: A stated probabilistic model or evidence-weighting method ranks the
claim above alternatives. Give the basis and uncertainty.
- Speculative: The claim is not refuted but has little positive support.
- Refuted: The claim conflicts with a trusted fact or necessary constraint.
- Unknown: Available evidence cannot classify the claim.
Let K = F ∪ C ∪ A, where F is accepted facts, C is constraints, and A
is explicit assumptions. For a consistent K and a claim q:
entailed: K ⊨ q refuted: K ∪ {q} is unsatisfiable
consistent: some model satisfies K ∪ {q}
Do not call uncertain premises facts. A valid deduction from an uncertain
assumption remains conditional on that assumption.
Run the investigation
- Frame the question. State the exact outcome, scope, time window, system
boundary, and required confidence. Preserve volatile evidence before tests
or remediation can change it.
- Build an evidence ledger. Give each item an ID. Record its type
(
observation, report, accepted fact, assumption, or constraint),
source, time, scope, reliability, and dependencies. Treat “the log contains
X” separately from “X occurred.”
- Check the base. Normalize terms and time zones. Flag conflicts, stale
records, missing intervals, and shared sources. If trusted premises
contradict, isolate disputed subsets; do not derive arbitrary conclusions
from the inconsistent set.
- Generate hypotheses abductively. Include distinct causal families,
ordinary failures, process or measurement error, and
other/unknown.
State any completeness claim. Do not confuse a good explanation with proof.
- Derive predictions. For each hypothesis, list what must be true, what
would be expected, what would distinguish it, and what would refute it.
Search for disconfirming evidence before confirming detail.
- Prune deductively. Refute a hypothesis only when it violates a trusted
fact or necessary constraint. Use a truth table, timeline, dependency graph,
CSP/SAT/SMT solver, query, or small model when manual consistency checks are
unreliable. Keep surviving hypotheses; survival alone adds no probability.
- Remove unsupported specificity. Map entailment or subsumption among
survivors. If
Hstrong ⊨ Hweak, then Hweak is weaker and the claims are
not mutually exclusive alternatives. Prefer the weakest claim that is still
adequate for the question or decision; retain stronger detail only when
evidence supports its added commitments. Do not confuse shorter wording with
logical weakness. Without a justified task distribution, weakness is a
reporting discipline, not evidence that a causal hypothesis is more likely.
- Rank survivors. Use base rates, evidence likelihood, causal fit, number
of unsupported assumptions, and source quality. Use
P(H|E) ∝ P(E|H)P(H) only when priors and likelihoods are defensible.
Otherwise use an explicit ordinal ranking. Do not double-count correlated
evidence.
- Choose the next test. Prefer evidence for which leading hypotheses make
different predictions. Balance expected discrimination against cost, delay,
risk, reversibility, and evidence destruction. Treat absent evidence as
evidence only when detection was expected and reliable.
- Update and stop deliberately. Add results to the ledger, withdraw
defeated defaults, and re-run consistency and ranking. Stop when the required
decision threshold is met, one safe action dominates across survivors, or
further evidence costs more than its decision value.
For formal framework selection, worked examples, and a copyable worksheet, read
the framework guide.
Report
Lead with the weakest decision-sufficient conclusion. Include:
- Question and scope.
- Accepted facts, constraints, and explicit assumptions.
- A hypothesis table with status, broader or narrower related hypotheses,
supporting evidence, conflicts, required assumptions, and decisive next test.
- Contradictions and evidence-quality limits.
- Conclusion labeled logically entailed, consistent, likely,
speculative, refuted, or unknown.
- Residual alternatives and the smallest next evidence-gathering action.
State whether a formal result proves the real system or only its model. Never
claim that one surviving explanation is true unless the hypothesis set is
demonstrably exhaustive and the evidence entails it.
1---2name: reason-from-evidence3description: Investigate evidence with explicit hypotheses and justified conclusions. Use when debugging systems, analyzing incidents or reports, reducing possible explanations, finding missing evidence, or separating proof, consistency, probability, and speculation.4---56# Reason from Evidence78Build an auditable case. Do not turn observations into conclusions by narration.910## Set the proof standard1112Use these labels exactly:1314- **Logically entailed:** Every admissible model of the stated facts, constraints,15 and assumptions makes the claim true.16- **Consistent with the facts:** At least one admissible model permits the claim.17 This is viability, not support.18- **Likely:** A stated probabilistic model or evidence-weighting method ranks the19 claim above alternatives. Give the basis and uncertainty.20- **Speculative:** The claim is not refuted but has little positive support.21- **Refuted:** The claim conflicts with a trusted fact or necessary constraint.22- **Unknown:** Available evidence cannot classify the claim.2324Let `K = F ∪ C ∪ A`, where `F` is accepted facts, `C` is constraints, and `A`25is explicit assumptions. For a consistent `K` and a claim `q`:2627```text28entailed: K ⊨ q refuted: K ∪ {q} is unsatisfiable29consistent: some model satisfies K ∪ {q}30```3132Do not call uncertain premises facts. A valid deduction from an uncertain33assumption remains conditional on that assumption.3435## Run the investigation36371. **Frame the question.** State the exact outcome, scope, time window, system38 boundary, and required confidence. Preserve volatile evidence before tests39 or remediation can change it.402. **Build an evidence ledger.** Give each item an ID. Record its type41 (`observation`, `report`, `accepted fact`, `assumption`, or `constraint`),42 source, time, scope, reliability, and dependencies. Treat “the log contains43 X” separately from “X occurred.”443. **Check the base.** Normalize terms and time zones. Flag conflicts, stale45 records, missing intervals, and shared sources. If trusted premises46 contradict, isolate disputed subsets; do not derive arbitrary conclusions47 from the inconsistent set.484. **Generate hypotheses abductively.** Include distinct causal families,49 ordinary failures, process or measurement error, and `other/unknown`.50 State any completeness claim. Do not confuse a good explanation with proof.515. **Derive predictions.** For each hypothesis, list what must be true, what52 would be expected, what would distinguish it, and what would refute it.53 Search for disconfirming evidence before confirming detail.546. **Prune deductively.** Refute a hypothesis only when it violates a trusted55 fact or necessary constraint. Use a truth table, timeline, dependency graph,56 CSP/SAT/SMT solver, query, or small model when manual consistency checks are57 unreliable. Keep surviving hypotheses; survival alone adds no probability.587. **Remove unsupported specificity.** Map entailment or subsumption among59 survivors. If `Hstrong ⊨ Hweak`, then `Hweak` is weaker and the claims are60 not mutually exclusive alternatives. Prefer the weakest claim that is still61 adequate for the question or decision; retain stronger detail only when62 evidence supports its added commitments. Do not confuse shorter wording with63 logical weakness. Without a justified task distribution, weakness is a64 reporting discipline, not evidence that a causal hypothesis is more likely.658. **Rank survivors.** Use base rates, evidence likelihood, causal fit, number66 of unsupported assumptions, and source quality. Use67 `P(H|E) ∝ P(E|H)P(H)` only when priors and likelihoods are defensible.68 Otherwise use an explicit ordinal ranking. Do not double-count correlated69 evidence.709. **Choose the next test.** Prefer evidence for which leading hypotheses make71 different predictions. Balance expected discrimination against cost, delay,72 risk, reversibility, and evidence destruction. Treat absent evidence as73 evidence only when detection was expected and reliable.7410. **Update and stop deliberately.** Add results to the ledger, withdraw75 defeated defaults, and re-run consistency and ranking. Stop when the required76 decision threshold is met, one safe action dominates across survivors, or77 further evidence costs more than its decision value.7879For formal framework selection, worked examples, and a copyable worksheet, read80[the framework guide](references/framework-guide.md).8182## Report8384Lead with the weakest decision-sufficient conclusion. Include:85861. Question and scope.872. Accepted facts, constraints, and explicit assumptions.883. A hypothesis table with status, broader or narrower related hypotheses,89 supporting evidence, conflicts, required assumptions, and decisive next test.904. Contradictions and evidence-quality limits.915. Conclusion labeled **logically entailed**, **consistent**, **likely**,92 **speculative**, **refuted**, or **unknown**.936. Residual alternatives and the smallest next evidence-gathering action.9495State whether a formal result proves the real system or only its model. Never96claim that one surviving explanation is true unless the hypothesis set is97demonstrably exhaustive and the evidence entails it.