ClaimCheck docs

Dimensions

Seven questions, always all seven, always in this order. The rubric file in the skill, skills/claimcheck/references/rubric.md, owns the wording.

# Dimension Question Typical failure
1 Mechanistic literacy Does the claim correctly model the physical/chemical/operational process? Treating withdrawal/consumption/recirculation/destruction as identical.
2 Quantitative and comparative literacy Does it locate magnitude relative to relevant baselines? Absolute numbers without denominators; selective focus ignoring larger uses.
3 Scale and boundary literacy Distinguishes local vs national/global, direct vs indirect, correct system boundaries? Flattening local stress with national totals or vice versa.
4 Trade-off and substitution literacy Recognizes reducing one input increases another? Treating one resource as independently bad without substitutes.
5 Output and value accounting Incorporates what the resource use produces? Labeling use “waste” solely because product is non-physical.
6 Recency and updating literacy Reflects current data, technology, revisions to earlier figures? Reliance on superseded estimates.
7 Source and evidentiary literacy Prefers primary measurements over secondary amplification? Single comparisons elevated over systematic reports.

Statuses

Status Use when Points
clear failure The claim commits the failure, and it changes what a reader would conclude 0
partial Half right, or right in one place and wrong in another 0.5
passed A reader could judge the claim on this axis 1
N/A The dimension does not apply left out of the denominator

A finding whose status depends on a figure your agent could not check carries the flag unverified. The status stands; the flag says what to check first.

Score

Points over applicable dimensions: 6 / 7, or 5 / 6 (1 N/A). The score is a summary line. The explanations are the product.

What counts as a finding

  • Quote the line, or name the absence and where it is.
  • A tone or word-choice note with no literacy consequence is not a finding.
  • A value judgment that names what it is weighing is not a finding.
  • A real concern can survive a failing claim. The report says what a stronger version would need.